qbithelparr

qbithelparr

Docker app from entree3000's Repository

Overview

qbithelparr bridges qBittorrent and Discord, allowing you to check torrent download status directly from your Discord server without opening the qBittorrent web interface. Using Discord's native slash commands, you can query your qBittorrent instance to see what's currently downloading, what's completed, and filter by media type (movies or TV shows). This is particularly useful for media server enthusiasts running Sonarr/Radarr automation who want quick status updates without leaving Discord. The bot connects to your qBittorrent WebUI and responds to /status commands in a designated Discord channel, displaying real-time progress, ETA, and torrent states. Messages auto-refresh and clean up after themselves to keep your channel organized. Version 2.0 brings modernized Discord.py 2.x support, proper slash commands, improved error handling, and automatic configuration file generation for easy Unraid deployment.

Requirements

Before installation, you must configure the values below. After first run, edit /mnt/user/appdata/qbithelparr/config.ini to make changes.

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

Discord Bot TokenVariable

Your Discord bot token from https://discord.com/developers/applications

Target
token
Default
your_discord_bot_token
Discord Channel IDVariable

The Discord channel ID where bot will respond (Enable Developer Mode in Discord, right-click channel, Copy ID)

Target
botChannel
Default
your_discord_channel_id
qBittorrent HostVariable

qBittorrent WebUI host (use container name if both on same Docker network)

Target
QBIT_HOST
Default
localhost
qBittorrent PortVariable

qBittorrent WebUI port

Target
QBIT_PORT
Default
8080
qBittorrent UsernameVariable

qBittorrent WebUI username

Target
QBIT_USER
Default
admin
qBittorrent PasswordVariable

qBittorrent WebUI password

Target
QBIT_PASS
TV CategoryVariable

qBittorrent category for TV shows (must match Sonarr category)

Target
TV_CATEGORY
Default
tv
Movie CategoryVariable

qBittorrent category for movies (must match Radarr category)

Target
MOVIE_CATEGORY
Default
movies
AppData Config PathPathrw

Container path for config.ini file

Target
/usr/src/app
Default
/mnt/user/appdata/qbithelparr
Value
/mnt/user/appdata/qbithelparr

Categories

Download Statistics

568
Total Downloads

Details

Repository
entree3000/qbithelparr:latest
Last Updated2026-01-10
First Seen2022-09-29

Run Qbithelparr on Unraid.

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