clutchless 0.1.0.dev7

A CLI tool to manage torrents and their data in Transmission

This is still under active development - use at your own risk!

Clutchless

Quick start

Install the package:

$ pip install clutchless

The -h flag can be used to bring up documentation, e.g. clutchless -h:

A tool for working with torrents and their data in the Transmission BitTorrent client.

Usage:
    clutchless [options] <command> [<args> ...]

Options:
    -a <address>, --address <address>   Address for Transmission (default is http://localhost:9091/transmission/rpc).
    -h, --help  Show this screen.
    --version   Show version.

The available clutchless commands are:
    add         Add torrents to Transmission (with or without data).
    find        Locate data that belongs to torrent files.
    link        For torrents with missing data in Transmission, find the data and fix the location.
    archive     Copy .torrent files from Transmission for backup.
    organize    Migrate torrents to a new location, sorting them into separate folders for each tracker.
    prune       Remove torrents from Transmission with completely missing data.

See 'clutchless help <command>' for more information on a specific command.

Examples

To copy all the .torrent files in Transmission to ~/torrent_archive:

clutchless archive ~/torrent_archive

To add some torrents to Transmission, searching ~/torrent_archive for .torrent files and finding data in ~/torrent_data:

clutchless add ~/torrent_archive -d ~/torrent_data

To look for matching data given a search folder (~/torrent_data) and a directory (~/torrent_files) that contains .torrent files:

clutchless find ~/torrent_files -d ~/torrent_data

To organize torrents into folders under ~/new_place and named by tracker, with default_folder for ones missing a folder name for one reason or another:

clutchless organize ~/new_place -d default_folder

Remove torrents that are completely missing data:

clutchless prune

To associate torrent to their matching data found in any number of folders (in this case just two):

clutchless link ~/data_folder_1 ~/data_folder_2