tqm

README

tqm

CLI tool to manage your torrent client queues. Primary focus is on removing torrents that meet specific criteria.

Example Configuration

clients:
  deluge:
    enabled: true
    filter: default
    download_path: /mnt/local/downloads/torrents/deluge
    free_space_path: /mnt/local/downloads/torrents/deluge
    download_path_mapping:
      /downloads/torrents/deluge: /mnt/local/downloads/torrents/deluge
    host: localhost
    login: localclient
    password: password-from-/opt/deluge/auth
    port: 58846
    type: deluge
    v2: true
  qbt:
    download_path: /mnt/local/downloads/torrents/qbittorrent/completed
    download_path_mapping:
      /downloads/torrents/qbittorrent/completed: /mnt/local/downloads/torrents/qbittorrent/completed
    enabled: true
    filter: default
    type: qbittorrent
    url: https://qbittorrent.domain.com/
    user: user
    password: password
filters:
  default:
    ignore:
      # general
      - Downloaded == false && !IsUnregistered()
      - SeedingHours < 26 && !IsUnregistered()
      # misc
      - FreeSpaceSet && FreeSpaceGB() > 2048 && !IsUnregistered()
      # permaseed / un-sorted (unless torrent has been deleted)
      - Label in ["permaseed-mine", "permaseed-btn", "permaseed-hdb", "permaseed-ptp", "permaseed-bhd", "permaseed-nbl", "permaseed-ufc", "radarr", "sonarr", "lidarr"] && !IsUnregistered()
    remove:
      # general
      - IsUnregistered()
      # imported
      - Label in ["sonarr-imported"] && (Ratio > 4.0 || SeedingDays >= 15.0)
      # ipt
      - Label in ["autoremove-ipt"] && (Ratio > 4.0 || SeedingDays >= 15.0)
      # mtv
      - Label in ["autoremove-mtv"] && (Ratio > 4.0 || SeedingDays >= 15.0)
      # hdt
      - Label in ["autoremove-hdt"] && (Ratio > 4.0 || SeedingDays >= 15.0)

Supported Clients

• Deluge
• qBittorrent
• rTorrent

Example Commands

1. Manage - Retrieve torrent client queue and run against configured filters

tqm manage deluge --dry-run

tqm manage deluge

tqm manage qbt --dry-run

tqm manage qbt

1. Orphan - Retrieve torrent client queue and local files/folders in download_path, remove orphan files/folders

tqm orphan deluge --dry-run

tqm orphan deluge

tqm orphan qbt --dry-run

tqm orphan qbt

---

Notes

FreeSpaceSet and FreeSpaceGB() are currently only supported for the following clients (when free_space_path is set):

• Deluge
• qBittorrent

FreeSpaceGB() will only increase as torrents are hard-removed.

This only works with one disk referenced by free_space_path and will not account for torrents being on different disks.

Donate

If you find this project helpful, feel free to make a small donation to the developer:

• Monzo: Credit Cards, Apple Pay, Google Pay

• Paypal: l3uddz@gmail.com

• GitHub Sponsor: GitHub matches contributions for first 12 months.

• BTC: 3CiHME1HZQsNNcDL6BArG7PbZLa8zUUgjL