qBit Manage is a Python utility that automates the tedious housekeeping in qBittorrent: tagging torrents by tracker, filing them into categories from their save path, clearing out unregistered torrents and orphaned files, and applying share limits per group.

What it automates

• Tags torrents automatically from their tracker URL, and can set the category from the tracker too.
• Assigns a category to uncategorised torrents based on their save path, and moves torrents between categories with cat_change.
• Removes unregistered torrents — it deletes the data only when the torrent is not being cross-seeded, otherwise it just removes the torrent entry.
• Rechecks paused torrents from smallest to largest and resumes them once they complete.
• Deletes orphaned files left in the root download directory that qBittorrent no longer references.
• Tags torrents that have no hard links outside the root folder, which exposes data that is not seeded from your media library.
• Applies share limits per group filtered by tag or category, with optional cleanup at a maximum ratio or seed time, a minimum seed time and a minimum number of seeders.
• Moves deleted data into a RecycleBin folder instead of deleting it outright.

Configuration and scheduling

Everything is driven by a single config.yml — categories, tracker-to-tag rules, share limit groups, notifications — and every value can be overridden with QBT_* environment variables. A built-in scheduler runs the script every x minutes, while --run executes a single cycle and exits, which is the mode used for cron jobs and container one-shots. A dry-run option reports what would change without touching qBittorrent.

Requirements and Installation

Python 3.11+ on Linux, Windows or macOS, a Docker image (bobokun/qbit_manage), and an unRAID template. It talks to qBittorrent through qbittorrent-api, so support for a new qBittorrent release arrives once that library supports it; the project tracks supported versions automatically.

Notifications

Webhook notifications through Notifiarr and Apprise API for run summaries, errors and per-command actions.

Licence

Open source — MIT licence. Developed by StuffAnThings (bobokun) and distributed as source, a Docker image and on PyPI.

Alternatives

• qBittorrent — the BitTorrent client it manages
• Unpackerr — extracts completed archives for the *arr stack
• Autobrr — automates torrent downloads from IRC announce channels