- Clearer text indicating what's happening
- Displays which qman file is causing torrents to be deleted
- For torrents to be deleted, waits 10 seconds before deleting so that the script can be cancelled (helpful when run manually during testing of qman files)
- Default configuration will not delete files without a manual file edit (script will display this when run)
Reads .qman files for JSON settings on when and how to delete torrents from a qBittorrent client
This program can delete all of your 500 torrents if allowed, so please be careful with the settings. Don't say i didn't warn you :)
Just clone the github repo or download it as a zip. Then run:
python3 qbit_ratio_manager.py
To run it regularily i recommend setting up a cron job or a Windows equivalent
Python 3
pip packages: jsonschema, requests
pip3 install jsonschema requests
| Argument | Explanation |
|---|---|
| --url | The url to the qBittorrent api. Ends in /api/v2/ unless you have a reverse proxy or similar. (you probably know if it's different for you) Default is http://127.0.0.1:8080/api/v2/ |
| --username | The username for the qBittorrent WebUI login |
| --password | The password for the qBittorrent WebUI login |
| --config_folder | Path to where the .qman files are stored. By default this is: (folder of the script)/config/ |
| --verbose -v | The verbosity level. 0 = only warnings, 1 = info, 2 = debug. Default is 0 |
The config files are in JSON and the file extensions have to be .qman
For every category / category+tracker configuration you create a new .qman file and fill in the settings for that specific category / category+tracker.
Multiple .qman files for the same category is allowed but should only be used in conjunction with the "tracker" setting
.qman example:
REMOVE COMMENTS FROM EXAMPLE BEFORE USING
{
"category": "test",
"tracker": "tracker.coppersurfer.tk", # Optional, remove unless needed
"public": {
"min_seed_ratio": 2,
"max_seed_ratio": 10000,
"min_seed_time": 1,
"max_seed_time": 960,
"required_seeders": 1 # Optional, remove unless needed
},
"private": {
"min_seed_ratio": 2,
"max_seed_ratio": 10000,
"min_seed_time": 480,
"max_seed_time": 960,
"required_seeders": 1 # Optional, remove unless needed
},
"delete_files": false,
"custom_delete_files_path": "/home/hundter/downloads" # Optional, remove unless needed
}
Line by line explanation:
| Argument | Explanation |
|---|---|
| category | The name of the qBittorrent category that this .qman file applies to. "*" can be used to apply to all categories that don't already have rules set from a different .qman file |
| tracker | Optional. Full tracker hostname, including subdomain if any (see example). Only scans torrents that match both the category and tracker setting |
| public | The settings for public torrents |
| min_seed_ratio | The minimum share ratio to reach before deletion. Only deletes if both minimum settings are satisfied |
| max_seed_ratio | The maximum share ratio to reach before deletion, regardless of minimum settings |
| min_seed_time | The minimum time to seed in hours before deletion. Only deletes if both minimum settings are satisfied. Only use whole numbers! |
| max_seed_time | The maximum time to seed in hours before deletion, regardless of minimum settings. Only use whole numbers! |
| required_seeders | Only delete torrent if it has at least this many seeders excluding yourself, to avoid killing dying torrents. Overrides max settings. |
| private | The settings for private torrents |
| delete_files | Whether qBittorrent should remove the files after deleting the torrent |
| custom_delete_files_path | Optional. A path to the category download location. Program then uses filesystem deletion directly instead of having qBittorrent delete the files. If the torrent is a folder it removes the folder regardless of any files in it. Overrides "delete_files" (Only use this if you understand what it does, you most likely don't need it) |