Description
Mariner is a command line torrent searcher. It offers a simple interface for streamlined experience. No more annoying ads and pop-up windows.
It is currently under heavy development, so expect breaking changes. Currently only works in Linux, but any contributions in this regard are welcome.
Mariner alternatives and similar packages
Based on the "Web Crawling" category.
Alternatively, view Mariner alternatives based on common mentions on social networks and blogs.
-
Scrapy
Scrapy, a fast high-level web crawling & scraping framework for Python. -
MechanicalSoup
A Python library for automating interaction with websites. -
RoboBrowser
A simple, Pythonic library for browsing the web without a standalone web browser. -
spidy Web Crawler
The simple, easy to use command line web crawler. -
Google Search Results in Python
Google Search Results via SERP API pip Python Package -
Crawley
Pythonic Crawling / Scraping Framework based on Non Blocking I/O operations. -
FastImage
Python library that finds the size / type of an image given its URI by fetching as little as needed
Write Clean Python Code. Always.
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Mariner or a related project?
README
Mariner

Navigate torrents in CLI with Mariner. It offers a simple interface for streamlined experience. No more annoying ads and pop-up windows.
It is currently under heavy development, so expect breaking changes. Currently only works in Linux, but any contributions in this regard are welcome.
Features
- Automatically get a working proxy for trackers that have them.
- Download torrent files and copy magnet links to clipboard.
- Open torrents in your default torrent application.
- Show torrent details.
- Asynchronous I/O for better responsiveness.
- Supports the following trackers:
- Anidex
- Archive.org
- Distrowatch
- Etree
- KickAssTorrents
- LimeTorrents
- Linuxtracker
- Nyaa
- NyaaPantsu
- ThePirateBay
- TokyoTosho
[Mariner demonstration](docs/assets/mariner.svg)
Installation
Mariner requires Python 3.5.3 or newer to run.
Python package
You can easily install Mariner using pip. This is the preferred method:
pip3 install mariner
Manual
Alternatively, to get the latest development version, you can clone this repository and then manually install it:
git clone [email protected]:radek-sprta/mariner.git
cd mariner
poetry build
pip install dist/*.whl
Usage
Mariner supports both interactive and non-interactive modes. To see the list of commands, simply type:
mariner help
In order to start Mariner in interactive mode, run it without any arguments:
mariner
Then search for Ubuntu torrents:
(mariner) search Ubuntu -t linuxtracker
and download the first result on the list:
(mariner) download 0
Alternatively, copy the magnet link to clipboard:
(mariner) magnet 0
Or open it in your torrent application:
(mariner) open 0
And quit the program:
(mariner) quit
For more information, check the documentation.
TODO
- Add more trackers for searching
- Support for MacOS and Windows
Contributing
For information on how to contribute to the project, please check the Contributor's Guide
Disclaimer
I do not encourage anyone to act in conflict with their local laws and I do not endorse any illegal activity. Some content in the search results provided be Mariner might be illegal in your country and it is up to you to check your local laws before using it. Neither I, nor Mariner can be held liable for any action taken against you as the result of using it.
Contact
[incoming+radek-sprta/[email protected]](incoming+radek-sprta/[email protected])
Acknowledgements
Mariner uses many excellent open-source libraries. But I would particularly like to mention the following, as without them, Mariner might not have been possible:
License
GNU General Public License v3.0
*Note that all licence references and agreements mentioned in the Mariner README section above
are relevant to that project's source code only.