https://github.com/datashaman/putio-automator

A suite of commands for managing torrents, transfers and files on put.io. Works well with SickRage, Sonarr, etc.
https://github.com/datashaman/putio-automator

docker media putio sickrage sonarr torrent

Last synced: 3 months ago
JSON representation

A suite of commands for managing torrents, transfers and files on put.io. Works well with SickRage, Sonarr, etc.

• Host: GitHub
• URL: https://github.com/datashaman/putio-automator
• Owner: datashaman
• License: mit
• Created: 2015-12-23T07:27:16.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2023-03-02T23:34:49.000Z (over 1 year ago)
• Last Synced: 2024-03-17T08:05:25.553Z (3 months ago)
• Topics: docker, media, putio, sickrage, sonarr, torrent
• Language: Python
• Homepage:
• Size: 170 KB
• Stars: 70
• Watchers: 8
• Forks: 17
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-piracy - Put.io automator

README

        
# put.io automator

A suite of commands for managing torrents, transfers and files on **Put.IO**

Configure Sickrage to use a Torrent black hole folder. Configure this application to

monitor that folder and download to the same folder used for post-processing in Sickrage.

**Note** Version 2 drops Docker and RPi support. The application should still run just fine in both contexts; however it is no longer directly supported. Also, support for Python 2 has been dropped.

## Table of Contents

* [Installation](#installation)

* [Configuration](#configuration)

* [Regular usage](#regular-usage)

  * [Torrents](#torrents)

  * [Files](#files)

  * [Transfers](#transfers)

  * [Database](#database)

## Installation

Install the putio-automator package locally **for your user**. System-wide installation is not supported.

    pip install --user putio-automator

This will install a new command-line utility `putio` in `$HOME/.local/bin`. Ensure it's on your path:

    echo 'PATH=$HOME/.local/bin:$PATH' >> .profile # or .bashrc or .zshrc, ymmv

## Configuration

Initialize the application with a basic configuration locally for your user:

    putio config init

This will interactively prompt you with some questions about where files should be stored, and your **Put.IO** `OAuth Token`.

To get an `OAuth Token` register your application on **Put.IO**, and copy the `OAuth Token` (found under the key icon).

**NB** The directories entered must be writable by the user running the application.

Check that the connection is working:

    putio account info

You should see a JSON packet with information about your account. If not, check your `OAuth Token` is correct.

To help you debug config issues, show the current config:

    putio config show

## Regular usage

### Torrents

Watch configured directory for torrents and add to **Put.IO**:

    putio torrents watch [-a] [-p PARENT_ID]

* -a, --add_existing

  Add existing torrents first.

* -p PARENT_ID, --parent_id PARENT_ID

  Parent folder to add files to.

Add existing torrents to **Put.IO**:

    putio torrents add [-p PARENT_ID]

* -p PARENT_ID, --parent_id PARENT_ID

  Parent folder to add files to.

### Files

List files on **Put.IO**:

    putio files list [-p PARENT_ID]

* -p PARENT_ID, --parent_id PARENT_ID

  Parent folder to list files from.

Download files from **Put.IO** to configured downloads directory:

    putio files download [-l LIMIT] [-c CHUNK_SIZE] [-p PARENT_ID]

* -l LIMIT, --limit LIMIT

  Maximum number of files to download in one go.

* -c CHUNK_SIZE, --chunk_size CHUNK_SIZE

  Defaults to 256kb.

* -p PARENT_ID, --parent_id PARENT_ID

  Parent folder to download files from.

* -f FOLDER, --folder FOLDER

  Folder in the downloads directory download to.

### Transfers

List transfers on **Put.IO**:

    putio transfers list

Cancel by status:

    putio transfers cancel_by_status statuses

* statuses

  Comma-delimited list of statuses.

Cancel completed transfers:

    putio transfers cancel_completed

Cancel seeding transfers:

    putio transfers cancel_seeding

Clean finished transfers:

    putio transfers clean

Groom transfers (cancels seeding and completed transfers, and cleans afterwards):

    putio transfers groom

### Database

The application records downloads in a SQLite database, so you don't inadvertently download the same file over and over when there's an error. This command clears the database record of a specific substring so you can download it again:

    putio db forget name

* name

  A substring found in the filename.