Command line torrent searcher
Project description
Mariner
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.
Features
- Search for torrents on Distrowatch, Linuxtracker, KickAssTorrents, PirateBay, TokyoTosho and more.
- 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.
Installation
Mariner requires Python 3.5 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 git@gitlab.com:radek-sprta/mariner.git
cd mariner
python3 setup.py install
Docker
There is now also a Docker image available for Mariner, although I haven't tested it extensively. You can run it with the following command:
docker run [options] registry.gitlab.com/radek-sprta/mariner [arguments]
Snap
You can also try the Mariner snap from snap store. Its in its, however, so do not be surprised by bugs. Install the snap by running:
snap install mariner --edge
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 want 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
License
GNU General Public License v3.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mariner-1.2.0.tar.gz
.
File metadata
- Download URL: mariner-1.2.0.tar.gz
- Upload date:
- Size: 31.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | df8f9e9d34dd6d6541b148da29d4095278ca0aed8bc34749656d96b9099e5b3b |
|
MD5 | c150eec41c368c1325757ac1f21b7f71 |
|
BLAKE2b-256 | 1bf1f8538f36ba827e5b975776be0f0fc046ff913008b9bcbb10a8b2c580380b |
File details
Details for the file mariner-1.2.0-py3-none-any.whl
.
File metadata
- Download URL: mariner-1.2.0-py3-none-any.whl
- Upload date:
- Size: 32.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b5a8c6c1cbb5d7dae4019f1bac70ea675eecd01ccd1c30e48f2e20f0d12d4627 |
|
MD5 | 68abbd26a43ddbba0189af5651146332 |
|
BLAKE2b-256 | 9ac9e47fa0cb514630f9bae81e7c131095f5ea32c880e39478afa09b63a370d6 |