discarr/docs/integrations/qbittorrent.md
pyr0ball dc768a8dbb docs: add MkDocs site
14-page documentation site covering installation, quick start,
full config reference, Sonarr/Radarr/qBittorrent/Tdarr integrations,
ffmpeg/HandBrake transcoder setup, SSH transcode workers, disc format
reference, and troubleshooting.

Stack: mkdocs-material 9.x (MIT), pinned <10 to avoid 2.0 licence wall.
2026-05-27 09:45:29 -07:00

1.3 KiB

qBittorrent Integration

Configure qBittorrent to notify Discarr when a torrent finishes downloading, so disc rips downloaded as torrents are scanned automatically.

1. Add the run-on-completion script

In qBittorrent, go to Tools → Options → Downloads.

Under Run external program on torrent completion, enter:

/opt/discarr/scripts/qbittorrent-notify.sh "%D"

%D passes the save path of the completed torrent to the script.

2. Configure qBittorrent credentials

In ~/.config/media-postprocessor/api-keys.conf:

QBIT_URL=http://your-qbit-host:8080
QBIT_USER=admin
QBIT_PASS=your-password

3. How it works

When a torrent completes, qBittorrent runs the script with the download directory. The script checks if the directory contains a disc structure (VIDEO_TS, BDMV, or ISO) and, if so, submits it to Discarr's scan queue automatically.

Torrent completes
      │
      ▼
qbittorrent-notify.sh "%D"
      │  checks for disc structure
      │  POST /api/scan {"path": "/media/downloads/..."}
      ▼
Discarr scan queue

4. DISCARR_URL

The script uses DISCARR_URL to find the Discarr instance. If qBittorrent and Discarr are not on the same host, set this in the config file:

DISCARR_URL=http://discarr-host:8603