Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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

Release History

This version
History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(7.6 kB) Copy SHA256 Hash SHA256
Source None Dec 25, 2015

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers DreamHost DreamHost Log Hosting