qbt-hub
Manage qBittorrent (v5.0+) via its WebUI API using the bundled scripts/qbt.py.
Authentication
Credentials are read from env vars (set once, reused forever):
QBT_HOST— e.g.http://qbt.example.comQBT_USER— WebUI usernameQBT_PASS— WebUI password
Can also be overridden per-call: --host / --user / --pass
Script Location
/var/minis/skills/qbt-hub/scripts/qbt.py
Alias for convenience:
bashalias qbt="python3 /var/minis/skills/qbt-hub/scripts/qbt.py"
Commands
Add a task
bash# magnet link python3 qbt.py add "magnet:?xt=urn:btih:..." # https .torrent URL python3 qbt.py add "https://example.com/file.torrent" # local .torrent file python3 qbt.py add ~/Downloads/movie.torrent # with options python3 qbt.py add "magnet:..." --savepath /data/movies --category Movies --tags "4K,DV" --paused --sequential
List / filter tasks
bashpython3 qbt.py list # all tasks python3 qbt.py list --filter downloading # active downloads python3 qbt.py list --filter completed python3 qbt.py list --tag 4K --sort size # filter by tag, sort by size python3 qbt.py list --category Movies --asc
Filter choices: all downloading seeding completed paused active inactive stalled errored
Sort choices: name size progress dlspeed upspeed ratio added_on
Search
bashpython3 qbt.py search ubuntu # fuzzy match on task name
Global status
bashpython3 qbt.py status # DL/UL speed, totals, limits, turtle mode
Task details
bashpython3 qbt.py info ubuntu # progress, files, trackers, peers
Pause / Resume / Recheck
bashpython3 qbt.py pause ubuntu python3 qbt.py resume all python3 qbt.py recheck ubuntu
Delete
bashpython3 qbt.py delete ubuntu # keep local files python3 qbt.py delete ubuntu --files # also delete local data
Speed limits
bash# per-task python3 qbt.py limit ubuntu --dl 500 --ul 100 # KB/s python3 qbt.py limit ubuntu --dl 0 # remove limit # global python3 qbt.py speedlimit # show current python3 qbt.py speedlimit --dl 2048 --ul 512 python3 qbt.py speedlimit --dl 0 # unlimited python3 qbt.py speedlimit --alt # toggle turtle mode
Tags
bashpython3 qbt.py tag ubuntu --tags "linux,iso" python3 qbt.py untag ubuntu --tags "iso" python3 qbt.py tags # list all tags with counts
Categories
bashpython3 qbt.py category ubuntu --cat Linux python3 qbt.py categories # list all categories
Rename / Move
bashpython3 qbt.py rename ubuntu --name "Ubuntu 24.04 LTS" python3 qbt.py move ubuntu --path /data/iso
Top N
bashpython3 qbt.py top --n 10 --sort size # largest tasks python3 qbt.py top --n 5 --sort dl # fastest downloads python3 qbt.py top --n 5 --sort ratio # highest ratio seeders
Sort choices: size dl ul ratio progress added
RSS
bashpython3 qbt.py rss list python3 qbt.py rss add --url "https://example.com/feed.rss" python3 qbt.py rss remove --path "FeedName" python3 qbt.py rss addrule --name "4K Shows" --pattern "2160p" --category TV python3 qbt.py rss removerule --name "4K Shows"
Workflow: Search the web and add a torrent
- Search for the torrent on sites like
torrentkitty.netorthepiratebay.orgusingbrowser_use - Extract the magnet link from the page
- Run
python3 qbt.py add "<magnet>" --savepath /path --tags "tag1,tag2"
Common patterns
bash# Check what's currently downloading python3 qbt.py list --filter downloading # Find and delete a large task including its files python3 qbt.py top --n 10 --sort size python3 qbt.py delete "keyword" --files # Tag all completed tasks python3 qbt.py list --filter completed # find keyword python3 qbt.py tag "keyword" --tags "done" # Slow down a task to save bandwidth python3 qbt.py limit "keyword" --dl 200 --ul 50
Notes
keywordmatching is case-insensitive fuzzy match on task name- Use
allas keyword to target every task (e.g.resume all,pause all) deletealways prompts for confirmation before executingrenamerequires an exact single match; use a more specific keyword if multiple tasks match- qBittorrent instance:
http://qbt.wsen.me(internal network, v5.0.2)


