Download Clients
Narratorr sends grabbed releases to your download client, then monitors progress and imports completed downloads into your library.
Go to Settings > Download Clients to add, edit, or remove clients.
qBittorrent
Section titled “qBittorrent”| Field | Default | Description |
|---|---|---|
| Host | — | Hostname or IP (e.g., qbittorrent for Docker, 192.168.1.50 for remote) |
| Port | 8080 | WebUI port |
| Username | — | WebUI username |
| Password | — | WebUI password |
| SSL | off | Enable for HTTPS connections |
qBittorrent’s WebUI must be enabled (Options > Web UI > Enable in qBittorrent).
Default credentials for a fresh qBittorrent install are typically admin / adminadmin. Change these immediately.
qBittorrent supports categories — Narratorr can tag its downloads for easy identification.
Transmission
Section titled “Transmission”| Field | Default | Description |
|---|---|---|
| Host | — | Hostname or IP |
| Port | 9091 | RPC port |
| Username | — | Optional — only if RPC authentication is enabled |
| Password | — | Optional — only if RPC authentication is enabled |
| SSL | off | Enable for HTTPS connections |
Transmission uses its RPC interface. Authentication is optional and disabled by default in most Transmission setups.
Transmission does not support categories — downloads go to the default download directory.
SABnzbd
Section titled “SABnzbd”| Field | Default | Description |
|---|---|---|
| Host | — | Hostname or IP |
| Port | 8080 | WebUI port |
| API Key | — | SABnzbd API key |
| SSL | off | Enable for HTTPS connections |
Finding Your SABnzbd API Key
Section titled “Finding Your SABnzbd API Key”- Open SABnzbd’s web interface
- Go to Config > General
- Copy the API Key (not the NZB key)
SABnzbd supports categories — Narratorr can tag its downloads for easy identification.
NZBGet
Section titled “NZBGet”| Field | Default | Description |
|---|---|---|
| Host | — | Hostname or IP |
| Port | 6789 | WebUI port |
| Username | — | NZBGet control username |
| Password | — | NZBGet control password |
| SSL | off | Enable for HTTPS connections |
Default NZBGet credentials are nzbget / tegbzn6789. Change these after first setup.
NZBGet supports categories — Narratorr can tag its downloads for easy identification.
Docker Networking
Section titled “Docker Networking”When both Narratorr and your download client run in Docker:
- Use the container name as the host (e.g.,
qbittorrent,sabnzbd), notlocalhost - Both containers must be on the same Docker network (they are by default if defined in the same
docker-compose.yml) localhostinside a container refers to that container itself, not the host machine
If your download client runs on the host (not in Docker), use host.docker.internal or the host’s LAN IP.
Testing
Section titled “Testing”After adding a download client, click Test to verify connectivity. If the test fails, see Troubleshooting > Download client won’t connect.