qbit_manage

qbit_manage

Docker app from bobokun's Repository

Overview

qbit_manage is a tool to manage your qBittorrent instance. It offers a range of features to automate your torrenting workflow, including:

  • Category and Tag Management: Automatically update categories based on save paths and add tags based on tracker URLs.
  • Torrent Cleanup: Remove unregistered torrents, orphaned files, and torrents without hardlinks.
  • Share Limits: Apply advanced share limits based on torrent groups, tags, and categories.
  • Health Checks: Recheck paused torrents and tag torrents with tracker errors.
  • Scheduler: Run tasks on a schedule or on-demand.
  • Web UI: A modern web interface to configure and manage qbit_manage, and trigger commands manually.

Runtime arguments

Web UI
http://[IP]:[PORT:8181]/
Network
bridge
Shell
sh
Privileged
false

Template configuration

PortPorttcp
Target
8181
Default
8181
Value
8181
Root_DirPathrw

Container Path: /Same/path/as/qbittorrent/downloads/

Target
/Same/path/as/qbittorrent/downloads/
Default
/mnt/user
Value
/mnt/user
QBT_CONFIG_DIRVariable

This is used to specify the configuration directory. It will treat all YAML files in this directory as valid configs.

Default
/config
Value
/config
QBT_LOGFILEVariable

This is used if you want to use a different name for your log file. Example: tv.log

Default
qbit_manage.log
Value
activity.log
QBT_RUNVariable

Run without the scheduler. Script will exit after completion.

Default
False|True
Value
False
QBT_SCHEDULEVariable

Schedule to run every x minutes. (Default set to 30)

Default
30
Value
30
QBT_WEB_SERVERVariable

Set to true to enable web API and web UI

Default
True|False
Value
true
QBT_PORTVariable

Web API port (default: 8181)

Default
8181
Value
8181
QBT_RECHECKVariable

Recheck paused torrents sorted by lowest size. Resume if Completed.

Default
False|True
Value
False
QBT_CAT_UPDATEVariable

Use this if you would like to update your categories.

Default
False|True
Value
False
QBT_TAG_UPDATEVariable

Use this if you would like to update your tags. (Only adds tags to untagged torrents)

Default
False|True
Value
False
QBT_TAG_TRACKER_ERRORVariable

Use this if you would like to tag torrents that do not have a working tracker.

Default
False|True
Value
False
QBT_SHARE_LIMITSVariable

Use this to help apply and manage your torrent share limits based on your tags/categories.

Default
False|True
Value
False
QBT_REM_UNREGISTEREDVariable

Use this if you would like to remove unregistered torrents. (It will the delete data & torrent if it is not being cross-seeded, otherwise it will just remove the torrent without deleting data)

Default
False|True
Value
False
QBT_REM_ORPHANEDVariable

Use this if you would like to remove orphaned files from your root_dir directory that are not referenced by any torrents. It will scan your root_dir directory and compare it with what is in qBittorrent. Any data not referenced in qBittorrent will be moved into /data/torrents/orphaned_data folder for you to review/delete.

Default
False|True
Value
False
QBT_TAG_NOHARDLINKSVariable

Use this to tag any torrents that do not have any hard links associated with any of the files. This is useful for those that use Sonarr/Radarr that hard links your media files with the torrents for seeding. When files get upgraded they no longer become linked with your media therefore will be tagged with a new tag noHL. You can then safely delete/remove these torrents to free up any extra space that is not being used by your media folder.

Default
False|True
Value
False
QBT_SKIP_CLEANUPVariable

Use this to skip cleaning up Recycle Bin/Orphaned directory.

Default
False|True
Value
False
QBT_DRY_RUNVariable

If you would like to see what is gonna happen but not actually move/delete or tag/categorize anything.

Default
True|False
Value
False
Appdata Config PathPathrw

Container Path: /config

Target
/config
Default
/mnt/user/appdata/qbit_manage
Value
/mnt/user/appdata/qbit_manage
QBT_LOG_LEVELVariable

Change the ouput log level.

Default
INFO
Value
INFO
QBT_DIVIDERVariable

Character that divides the sections (Default: '=')

Default
=
Value
=
QBT_WIDTHVariable

Screen Width (Default: 100)

Default
100
Value
100

Details

Repository
ghcr.io/stuffanthings/qbit_manage:latest
Last Updated2026-05-31
First Seen2025-08-28

Run qbit_manage on Unraid.

qbit_manage is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.