MediaManager/Writerside/topics/download-client-configuration.md

Download Clients

Download client settings are configured in the [torrents] section of your config.toml file. MediaManager supports both qBittorrent and SABnzbd as download clients.

qBittorrent Settings ([torrents.qbittorrent])

qBittorrent is a popular BitTorrent client that MediaManager can integrate with for downloading torrents.

• enabled

Set to true to enable qBittorrent integration. Default is false.

• host

Hostname or IP of the qBittorrent server. Include the protocol (http/https).

• port

Port of the qBittorrent Web UI/API. Default is 8080.

• username

Username for qBittorrent Web UI authentication. Default is admin.

• password

Password for qBittorrent Web UI authentication. Default is admin.

SABnzbd Settings ([torrents.sabnzbd])

SABnzbd is a Usenet newsreader that MediaManager can integrate with for downloading NZB files.

• enabled

Set to true to enable SABnzbd integration. Default is false.

• host

Hostname or IP of the SABnzbd server.

• port

Port of the SABnzbd API. Default is 8080.

• api_key

API key for SABnzbd. You can find this in SABnzbd's configuration under "General" → "API Key".

Example Configuration

Here's a complete example of the download clients section in your config.toml:

[torrents]
    # qBittorrent configuration
    [torrents.qbittorrent]
    enabled = true
    host = "http://qbittorrent"
    port = 8080
    username = "admin"
    password = "your_secure_password"

    # SABnzbd configuration
    [torrents.sabnzbd]
    enabled = false
    host = "sabnzbd"
    port = 8080
    api_key = "your_sabnzbd_api_key"

Docker Compose Integration

When using Docker Compose, make sure your download clients are accessible from the MediaManager backend:

services:
  # MediaManager backend
  backend:
    image: ghcr.io/maxdorninger/mediamanager/backend:latest
    # ... other configuration ...

  # qBittorrent service
  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    ports:
      - "8080:8080"
    environment:
      - WEBUI_PORT=8080
    volumes:
      - ./data/torrents:/downloads
    # ... other configuration ...

  # SABnzbd service (optional)
  sabnzbd:
    image: lscr.io/linuxserver/sabnzbd:latest
    ports:
      - "8081:8080"
    volumes:
      - ./data/usenet:/downloads
    # ... other configuration ...

You can enable both qBittorrent and SABnzbd simultaneously if you want to support both BitTorrent and Usenet downloads. Make sure the download directories in your download clients are accessible to MediaManager for proper file management and organization.