Skip to main content

Command line torrent searcher

Project 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.

Features

  • Search for torrents on Distrowatch, Linuxtracker, KickAssTorrents, PirateBay and TokyoTosho.

  • 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.

Mariner demonstration

Mariner demonstration

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

  • Offer more configuration options

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

mail@radeksprta.eu

incoming+radek-sprta/mariner@gitlab.com

License

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.

Source Distribution

mariner-1.0.2.tar.gz (29.8 kB view details)

Uploaded Source

Built Distribution

mariner-1.0.2-py3-none-any.whl (26.8 kB view details)

Uploaded Python 3

File details

Details for the file mariner-1.0.2.tar.gz.

File metadata

  • Download URL: mariner-1.0.2.tar.gz
  • Upload date:
  • Size: 29.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for mariner-1.0.2.tar.gz
Algorithm Hash digest
SHA256 4377e1ec3e0abd27058cc0f07e7efcd9c31fc157a143ec7f052bd6cf30e5a3d6
MD5 4899b2146b260f578fcae0e8e7a872f2
BLAKE2b-256 1bf6b2dfc1bf1fc29879f59bab6da3ed8f78e574c4f214509e85bc186bfff4de

See more details on using hashes here.

File details

Details for the file mariner-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mariner-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2d98a65afc1e4e6ff040220a46eea14a3a6a380bbbd782445c4099f1889bd915
MD5 c18628f91fb392efb7592c4a5de3e326
BLAKE2b-256 ea39ba3ed516a7c247a4548936b5acfcf9eb7fac002fa3a60dc70a49a678bfab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page