Torrench - Command-line torrent search tool

Build Status GitHub release PyPI AUR PyPI Dependency Status


mix (Click to expand) (More samples)


About

Torrench is a command-line program to search and download torrents from torrent-hosting sites. It’s compatible under Windows, Linux and MacOS.

Following websites are supported:

I have tested it on following platforms (and it works great):

[Reported by users]

* Using TPB/KAT/SkyT/Nyaa/XBit

By default, searching thepiratebay(TPB)/kickasstorrents(KAT)/SkyTorrents/Nyaa (anime)/XBit from torrench is disabled. The user should configure and enable it to use. I have provided configuration steps, but before moving to configuration, please note the following:

Torrench initially began as a python learning project for me. I am sure there are ways to implement code I wrote in a much better/efficient way. Do let me know. Alternatively, you can also send a pull request. See Contributing.


Installation/Building from Source

Linux

Windows

Windows does not require any additional packages. Everything required to run this software is provided in executable (Does not even require python pre-installed).

Configuration instructions:

  1. Download config.ini from Sync / TinyUpload
    • Windows - Copy the config file in C:\Users\<user>\.config\torrench\ (create any missing directories)
    • Linux - Default location is $XDG_CONFIG_HOME/torrench/. If $XDG_CONFIG_HOME is not defined, it fallbacks to $HOME/.config/torrench/ (Create any missing directories).
    • MacOS - Next bullet (setup instructions).
  2. Enable it
    • Open config.ini file
    • Set enable=1
    • Save and exit
  3. That’s it.

Config file minimal setup guide (Windows/Linux/MacOS)


Usage

$ torrench SEARCH_STRING  ## Search linuxtracker
$ torrench -d SEARCH_STRING ## Search distrowatch
$ torrench [Options] <SEARCH_STRING>

Options

    positional arguments:
      search                Enter search string

    optional arguments:
      -h, --help            show this help message and exit
      -d, --distrowatch     Search distrowatch
      -t, --thepiratebay    Search thepiratebay (TPB)
      -k, --kickasstorrent  Search KickassTorrent (KAT)
      -s, --skytorrents     Search SkyTorrents
      -n, --nyaa            Search Nyaa
      -x, --xbit            Search XBit.pw
      --top                 Get top torrents [TPB/SkyTorrents]
      -p LIMIT, --page-limit LIMIT
                            Number of pages to fetch results from (1 page = 30 results).
                            [default: 1] [TPB/KAT/SkyTorrents]
      -c, --clear-html      Clear all [TPB] torrent description HTML files and exit.
      -v, --version         Display version and exit.

Features

[TPB/KAT]

[TPB-Only]

Note


Samples

$ torrench "ubuntu desktop 16.04"	## Search Linuxtracker for Ubuntu Desktop 16.04 distro ISO
$ torrench "fedora workstation"	## Search for Fedora Workstation distro ISO
$ torrench -d "opensuse" ## Search distrowatch for opensuse ISO
$ torrench -d "solus" ## Search distrowatch for solus ISO
$ torrench -x "fedora" ## Search XBit for fedora distros ISO

Linuxtracker

ubuntu fedora

DistroWatch

distrowatch distrowatch

XBit[.]pw

xbit xbit


Searches considered illegal

TPB Examples

$ torrench -t "suicide squad"	## Search suicide squad TPB
$ torrench -t "game of thrones s07e02" -p 2	## Search and fetch 2 pages TPB for GOT s07e02

illegal

illegal (Dynamically-generated Torrent description HTML page)

illegal (Click to expand)

KAT Examples

$ torrench -k "doctor strange"
$ torrench -k "guardians of the galaxy"

illegal

illegal (Click to expand)

SkyTorrents Examples

$ torrench -s "hannibal"
$ torrench -s "narcos"

illegal

illegal (Click to expand)

Nyaa[.]si Examples

$ torrench -n "naruto"

illegal

illegal


Disclaimer

This tool fetches torrent and details from already existing torrent website(s). I do not take any responsibility for availability of any kind of torrent data, or/and hosting of any torrent website(s). Also, I am not responsible for closing of any of the torrent website(s). As long as the website(s) (proxies) are available, data will be fetched.

Contributing (Bug reports/suggestions/feedbacks)

Please see CONTRIBUTING

Contact

Thank you

Licence

Copyright (C) 2017 Rijul Gulati <kryptxy@protonmail.com>

Torrench is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Torrench is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Torrench.  If not, see <http://www.gnu.org/licenses/>.