Skip to main content

Auto Remove Torrents

This unofficial app installation script is provided for your convenience. The script is provided as-is and may not be updated or maintained by Ultra.cc. Customers are welcome to use and customize unofficial app installers for their unique needs and requirements. Unofficial support may be offered via Discord only and at the sole discretion of Ultra.cc staff. Use at your own risk and only proceed if you are comfortable managing the application on your own.

Autoremove Torrents Guide

Autoremove Torrents is an open source Python project that allows automatically removing torrents from various torrent clients based on configurable criteria. It can help free up disk space by deleting torrents when they are finished seeding.

Features

  • Remove torrents automatically based on ratio, seeding time, inactivity and more
  • Monitor disk space and remove torrents if space runs low
  • Remove oldest, biggest, smallest torrents first
  • Support for all major torrent clients
  • Dry run mode to test without removing
  • Schedule via crontab for hands-off automation

Supported Clients

Autoremove Torrents works with the following torrent clients:

It supports connecting to the web UI for qBittorrent, Transmission, and μTorrent. For Deluge, it connects directly to the daemon via the RPC protocol.

Installation

  • Connect to your Ultra.cc service via SSH
  • There are two ways to install Autoremove Torrents:

From PyPI

This will install the latest stable release:

pip install autoremove-torrents

From Source

This allows installing the development version:

git clone https://github.com/jerrymakesjelly/autoremove-torrents.git
cd autoremove-torrents
python setup.py install

Configuration

Autoremove Torrents uses a YAML configuration file to define the torrent clients and removal rules.

Client Configuration

First, you need to specify connection details for each torrent client:

qbittorrent:
  client: qbittorrent
  host: http://192.168.1.100:8080
  username: admin
  password: adminadmin

deluge:
  client: deluge
  host: 192.168.1.101:58846
  username: localclient
  password: password123

The client parameter specifies the client name, while host contains the URL or IP address + port. The username and password are login credentials for the web UI or daemon.

Removal Strategies

Next, define removal strategies under each client. For example:

strategies:

  delete_seeds:
    remove: ratio > 2

  clear_space:
    free_space:  
      min: 10
      path: /downloads
      action: remove-big-seeds

You can customize removal rules based on ratio, seed time, activity, disk space and more. See the full documentation for details on all available options.

Strategies will only apply to the client they are defined under. You can create multiple strategies per client.

Running Autoremove Torrents

To run with the default config.yml:

autoremove-torrents --config config.yml

Or specify a custom config path:

autoremove-torrents --config /home/user/myconfig.yml

Single Task:

autoremove-torrents --config config.yml --task transmission

Add --view to do a dry run and see what would be deleted without actually removing anything.

Automation

You can setup a cron job or scheduled task to run autoremove-torrents automatically. For example:

# Run at 2AM every day
0 2 * * * /path/to/autoremove-torrents --config /home/user/myconfig.yml

Uninstalling

If installed via pip:

pip uninstall autoremove-torrents

For manual installs, delete the autoremove-torrents folder and any installed files/packages.

Back to top