Mariner 
Navigate torrents in CLI with Mariner. It offers a simple interface for a streamlined experience without annoying ads and pop-up windows.
Features
- Works on Linux and Windows
- Download torrent files and copy magnet links to clipboard
- Open torrents in your default torrent application
- Show detailed torrent information (seeders, leechers, upload date, size)
- Interactive and non-interactive modes
- Asynchronous I/O for responsive performance
- Extensible via YAML-based tracker definitions
- Supports multiple trackers:
- LimeTorrents
- LinuxTracker
- Nyaa
- TokyoTosho
Installation
Mariner requires Python 3.10 or newer.
Python package
Install from PyPI using pip:
pip3 install mariner
From source
Clone the repository and build locally:
git clone git@gitlab.com:radek-sprta/mariner.git
cd mariner
uv build
pip install dist/*.whl
Usage
Interactive Mode
Start the interactive shell:
mariner
Then search for torrents:
(mariner) search Ubuntu -t linuxtracker
(mariner) download 0
(mariner) quit
Non-Interactive Mode
Search for torrents:
mariner search Ubuntu -t linuxtracker
Download results:
mariner download 0 1 2
Copy magnet link to clipboard:
mariner magnet 0
Open in torrent application:
mariner open 0
View torrent details:
mariner details 0
For more information and options, run:
mariner search --help
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/mariner@gitlab.com
Acknowledgements
Mariner uses excellent open-source libraries:
- BeautifulSoup — HTML parsing
- Cliff — CLI framework
- httpx — Async HTTP client
- ruamel.yaml — YAML parsing and serialization
- Cachalot — Caching
- platformdirs — Platform-specific paths
License
GNU General Public License v3.0
1 maintainer
Metadata
1 maintainer
Release files for mariner 1.6.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| mariner-1.6.0.tar.gz | 63.8 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mariner-1.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 129.9 kB
Release files / mariner-1.6.0.tar.gz
| Download URL | mariner-1.6.0.tar.gz |
|---|---|
| Size | 63.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6ab4328b9975d52a77d6ed8b11c5a5fd9a934983ece9f22506e162b902e0c015
|
|
BLAKE2b-256 checksum How to use checksums |
b69091911cdd09c81d19b3acd967b92582afb588068d134e3cbd808d3df0700b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"openSUSE Tumbleweed","version":"20260308","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mariner-1.6.0-py3-none-any.whl
| Download URL | mariner-1.6.0-py3-none-any.whl |
|---|---|
| Size | 66.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5cbf90ecc8429f299c4dd49e07444974f594fe77cc4b2c7644459c5036cf236c
|
|
BLAKE2b-256 checksum How to use checksums |
e5ad002566a07585770132da500ae38d48285d47be2801945ae4e030005f70a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.10.8 {"installer":{"name":"uv","version":"0.10.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"openSUSE Tumbleweed","version":"20260308","id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for mariner 1.6.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
