This is an opinionated fork of the upstream project at https://gitlab.com/AlexKM/qbittools.
qbittools is a feature rich CLI for the management of torrents in qBittorrent.
Run a container with access to host network:
docker run -it --rm --network host github.com/buroa/qbittools tagging --unregistered# clone the repository
git clone https://github.com/buroa/qbittools.git && cd qbittools
# build the image
docker build -t qbittools:latest --pull .
# run a container with the resulting binary and access to host network
docker run -it --rm --network host qbittools reannounce -p 12345You have to specify your password every time with -P flag unless you enable Web UI -> Bypass authentication for clients on localhost in qBittorrent's settings, because there is no way for qBittools to retrieve it in plaintext.
You also can specify host, port and username manually without a configuration file with -s, -p and -U flags accordingly.
There is also a config.yaml file which can be overrideen to add your own indexers and their corresponding requirements.
All commands have extensive help with all available options.
$ qbittools export -h
usage: qbittools.py reannounce [-h] [--pause-resume] [--process-seeding]
[-c /app/config.yaml] [-p 12345] [-s 127.0.0.1] [-U username]
[-P password]
options:
-h, --help show this help message and exit
--pause-resume Will pause/resume torrents that are invalid.
--process-seeding Will also process seeding torrents for reannouncements.
-c /app/config.yaml, --config /app/config.yaml
-p 12345, --port 12345
port
-s 127.0.0.1, --server 127.0.0.1
host
-U username, --username username
-P password, --password passwordCreate useful tags to group torrents by tracker domains, not working trackers, unregistered torrents and duplicates
$ qbittools tagging --duplicates --unregistered --not-working --added-on --trackersAutomatic reannounce on problematic trackers
$ qbittools reannounce
07:40:40 PM --------------------------
07:40:40 PM [Movie.2020.2160p.WEB-DL.H264-GROUP] is not working, active for 1s, reannouncing...
07:41:20 PM --------------------------
07:41:20 PM [Movie.2020.2160p.WEB-DL.H264-GROUP] has no seeds, active for 78s, reannouncing...
07:41:25 PM --------------------------
07:41:25 PM [Movie.2020.2160p.WEB-DL.H264-GROUP] is active, progress: 0%
07:41:30 PM --------------------------
07:41:30 PM [Movie.2020.2160p.WEB-DL.H264-GROUP] is active, progress: 5.0%
07:41:35 PM --------------------------
07:41:35 PM [Movie.2020.2160p.WEB-DL.H264-GROUP] is active, progress: 11.1%Find files no longer associated with any torrent, but still present in download folders (default download folder and folders from all categories). This command will remove orphaned files if you pass the --confirm flag.
This command is very opinionated on a certian directory structure so use with caution and make sure you run it without the --confirm flag to make sure it won't delete anything unintentional.
This is how I have my paths laid out where /downloads/qbittorrent/complete is the default save path in qBittorrent and each folder under it is a category. Default Torrent Management Mode: Automatic, When Torrent Category changed: Relocate, When Default Save Path changed: Relocate affected torrents and When Category Save Path changed: Relocate affected torrents is also set. Also make sure you use an incomplete directory that is outside the /downloads/qbittorrent/complete directory.
/downloads/qbittorrent
└── complete
├── cross-seed
├── hit-and-runs
├── lidarr
├── manual
├── myanonamouse
├── overlord
├── prowlarr
├── radarr
├── redacted
├── rifftrax
└── sonarr
$ qbittools orphaned --ignore-pattern "*_unpackerred" --ignore-pattern "*/manual/*"