Torrench - Command-line torrent search tool

Build Status Codacy Badge GitHub release PyPI AUR PyPI Dependency Status Say Thanks


cross-site

(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. Torrench supports following websites:

Supported Sites

Tested on following platforms:

[Reported by users]

IMPORTANT - Please keep a close eye on CHANGELOGS. All updates info, addition setup info (whenever required), and everyting else related will be updated there.


* [D] Sites hosting illegal content (Disabled) (MUST READ)

By default, searching thepiratebay(TPB)/kickasstorrents(KAT)/SkyTorrents/Nyaa/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).

Osx

Please note OSX requires to install package pyopenssl:

$ pip3 install pyopenssl

Configuration instructions:

  1. Download the config.ini file.
    • 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 - See minimal setup guide below.
  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

optional arguments:
    -h, --help            show this help message and exit
    -v, --version         Display version and exit.
    -C, --cross_site      Enable cross-site search
    -U, --update-config   Update config.ini file.
    --interactive         Enable interactive mode for searches
    --no-merge            (Cross-site) Do not merge results in one table
    --sorted              (Cross-site) sort results on basis of Seeds.

Main Sites:
    search                Search LinuxTracker (default)
    -d, --distrowatch     Search Distrowatch

Optional Sites:
  Requires configuration (disabled by default)

    -t, --thepiratebay    Search thepiratebay (TPB)
    -k, --kickasstorrent  Search KickassTorrent (KAT)
    -s, --skytorrents     Search SkyTorrents
    -x, --x1337           Search 1337x
    -r, --rarbg           Search RarBg
    -n, --nyaa            Search Nyaa
    -l, --limetorrents    Search LimeTorrents
    -i, --idope           Search Idope
    -b, --xbit            Search XBit.pw
    -g, --libgen          Search LibGen (Ebooks)

Additional options:
    -c, --clear-html      Clear all [TPB] torrent description HTML files and exit.
    -p LIMIT, --page-limit LIMIT
                            Number of pages to fetch results from. [default: 1]
    --copy                Copy magnetic link to clipboard
    --top                 Get TOP torrents [TPB/SkyTorrents]

Features


Loading torrent to client

[LINUX/MacOS]

[Windows]


It is possible to search multiple sites with a single command (Cross-site search)

Sample

$ torrench -Ctisx 'ubuntu'

cross-site

USAGE


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
$ torrench -l 'arch linux'  ## Search limetorrents for Arch linux disro ISO

Linuxtracker

$ torrench "fedora workstation"

linuxtracker linuxtracker

DistroWatch

$ torrench -d "ubuntu"

distrowatch

1337x

$ torrench -x "ubuntu"

1337x

Idope

$ torrench -i "opensuse"

illegal

LimeTorrents

$ torrench -l "arch linux"

illegal

XBit

$ torrench -x "fedora"

xbit


Searches considered illegal

TPB Examples

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

illegal

illegal (Dynamically-generated Torrent description HTML page)

illegal (Click to expand)

LibGen (Ebooks) (Search using ISBN-10)

$ torrench -g 1593272901

illegal

KAT

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

RarBg

$ torrench -r "mr robot"

SkyTorrents

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

Nyaa

$ torrench -n "naruto"

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.

Known issues

$ sudo pip3 install wcwidth

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