Torrent Clients
Configure qBittorrent, Deluge, Transmission, rTorrent, or uTorrent for torrent downloads.
Comicarr supports five torrent clients plus a watchfolder fallback.
Torrent Downloader Selection
| Setting | Type | Default | Description |
|---|---|---|---|
TORRENT_DOWNLOADER | int | 0 | Active torrent client: 0 = Watchfolder, 1 = uTorrent, 2 = rTorrent, 3 = Transmission, 4 = Deluge, 5 = qBittorrent. |
qBittorrent is the recommended torrent client. Set TORRENT_DOWNLOADER to 5.
| Setting | Type | Default | Description |
|---|---|---|---|
QBITTORRENT_HOST | string | — | qBittorrent Web UI URL (e.g. http://localhost:8080). |
QBITTORRENT_USERNAME | string | — | Web UI username. |
QBITTORRENT_PASSWORD | string | — | Web UI password. Encrypted at rest. |
QBITTORRENT_LABEL | string | — | Category/label applied to Comicarr downloads. |
QBITTORRENT_FOLDER | string | — | Override download directory. |
QBITTORRENT_LOADACTION | string | default | Action on torrent add: default, force_start, or paused. |
Create the category in qBittorrent before using it. Go to the qBittorrent Web UI, right-click the left sidebar, and select New Category.
Deluge communicates via its daemon API. Set TORRENT_DOWNLOADER to 4.
| Setting | Type | Default | Description |
|---|---|---|---|
DELUGE_HOST | string | — | Deluge daemon host and port (e.g. http://localhost:8112). |
DELUGE_USERNAME | string | — | Deluge daemon username. |
DELUGE_PASSWORD | string | — | Deluge daemon password. Encrypted at rest. |
DELUGE_LABEL | string | — | Label plugin label for Comicarr downloads. Requires the Label plugin. |
DELUGE_PAUSE | bool | False | Add torrents in a paused state. |
DELUGE_DOWNLOAD_DIRECTORY | string | — | Override the download directory. |
DELUGE_DONE_DIRECTORY | string | — | Directory to move completed downloads to. |
The Label plugin must be enabled in Deluge before setting DELUGE_LABEL. Enable it under Preferences > Plugins.
Transmission uses its RPC interface. Set TORRENT_DOWNLOADER to 3.
| Setting | Type | Default | Description |
|---|---|---|---|
TRANSMISSION_HOST | string | — | Transmission RPC URL (e.g. http://localhost:9091). |
TRANSMISSION_USERNAME | string | — | RPC username. |
TRANSMISSION_PASSWORD | string | — | RPC password. Encrypted at rest. |
TRANSMISSION_DIRECTORY | string | — | Override download directory. |
rTorrent communicates via XML-RPC. Set TORRENT_DOWNLOADER to 2.
| Setting | Type | Default | Description |
|---|---|---|---|
RTORRENT_HOST | string | — | rTorrent XMLRPC URL (e.g. http://localhost/RPC2). |
RTORRENT_AUTHENTICATION | string | basic | HTTP authentication method: basic, digest, or none. |
RTORRENT_RPC_URL | string | — | Custom RPC URL path if different from the host path. |
RTORRENT_SSL | bool | False | Connect using HTTPS. |
RTORRENT_VERIFY | bool | True | Verify TLS certificates. |
RTORRENT_CA_BUNDLE | string | — | Path to a custom CA bundle for self-signed certificates. |
RTORRENT_USERNAME | string | — | XMLRPC username. |
RTORRENT_PASSWORD | string | — | XMLRPC password. Encrypted at rest. |
RTORRENT_STARTONLOAD | bool | True | Start the torrent immediately after adding. |
RTORRENT_LABEL | string | — | Label applied to Comicarr downloads. |
RTORRENT_DIRECTORY | string | — | Override download directory. |
uTorrent uses its Web API. Set TORRENT_DOWNLOADER to 1.
| Setting | Type | Default | Description |
|---|---|---|---|
UTORRENT_HOST | string | — | uTorrent Web UI URL (e.g. http://localhost:8080/gui). |
UTORRENT_USERNAME | string | — | Web UI username. |
UTORRENT_PASSWORD | string | — | Web UI password. Encrypted at rest. |
UTORRENT_LABEL | string | — | Label applied to Comicarr downloads. |
Watchfolder mode saves .torrent files to a directory that your torrent client monitors. Set TORRENT_DOWNLOADER to 0.
Configure your torrent client to watch a specific directory for new .torrent files. Comicarr will save torrents to that directory automatically.
Watchfolder mode works with any torrent client that supports watched directories, making it a universal fallback.