Skip to main content

Torrent extraction automation

Project description

torex is an open source application for automatic torrent extraction.


You can install through PyPi:

`bash pip install torex `

Or just download the sources (manually or clone from GitHub) and run:

`bash python install `


The command for running torex is just torex.

The command-line interface is:

`bash torex <config_path> <torrent_path> <label> `

Where: * config_path: Configuration file path * torrent_path: The path to the downloaded torrent * label: The torrent’s label (will be explained later on)

uTorrent Setup

The script is particularly easy to run from uTorrent. Under Preferences, go to Advanced -> Run Program. Then, set the program to be run:

`bash torex <config_path> "%D" "%L" `

Finally, when you add a torrent that should be extracted, just make sure it is assigned the correct label in uTorrent.


Supported torrent labels: * tv - A TV series torrent (Formatted like Breaking Bad S01E01)


The configuration file is a YAML file, that tells torex where it should extract the torrents to. You can take a look at config_example.yaml for an example of what a configuration file should look like.

Under the label, you can define a root path that the torrents will be extracted to. Every torrent will be extracted to a subdirectory with the TV series’ name.

You can define an array of special types, each containing two fields: * title: A regex for matching a torrent’s title * path: The path that these torrents should be extracted to

The special configuration is particularly useful when you have a big drive that holds all your downloads, but you want some specific torrents to be extracted somewhere else.

Torrent Types

Right now, the only supported torrents are torrents that are a single directory with a single .rar file to be extracted.


torex writes logs to ~/.torex/logs.txt

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for torex, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size (7.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page