Skip to main content

Navigate torrents in CLI

Project description

Mariner PyPI version Pipeline status Coverage report Downloads Black

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.


  • Runs on Linux and Windows.
  • 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:
    • Distrowatch
    • Etree
    • LimeTorrents
    • Linuxtracker
    • Nyaa
    • NyaaPantsu
    • TokyoTosho

Mariner demonstration


Mariner requires Python 3.6 or newer to run.

Python package

You can easily install Mariner using pip. This is the preferred method:

pip3 install mariner


Alternatively, to get the latest development version, you can clone this repository and then manually install it:

git clone
cd mariner
poetry build
pip install dist/*.whl


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:


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.


For information on how to contribute to the project, please check the Contributor's Guide


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.




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:


GNU General Public License v3.0

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mariner, version 1.5.1
Filename, size File type Python version Upload date Hashes
Filename, size Mariner-1.5.1.tar.gz (33.9 kB) File type Source Python version None Upload date Hashes View
Filename, size Mariner-1.5.1-py3-none-any.whl (60.4 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page