qBittorrent Seed Type

Maintains the "Solo-seed" or "Cross-seed" tag on each torrent. Cross-seeding is determined by a torrent having a single file which appears in another.

This tool is provided as a Docker container which runs as a cron job.

Usage

The container connects to qBittorrent over its API which is exposed the same way as its web interface. You will need a valid username and password. The default username is 'admin', and the default password is 'adminadmin' which reflect the qBittorrent defaults.

There are three general ways to connect:

1. Use the qBittorrent container as the network for this container.
2. Use the qBittorrent container hostname.
3. Use an explicit hostname/IP that resolves to the container.

Option 2 and option 3 are really the same thing and are the recommended path.

For option 2, ensure your qBittorrent container has a hostname defined. For docker run this means specifying --hostname qbittorrent. For Docker Compose use the hostname key in the service definition:

services:
  qbittorrent:
    image: linuxserver/qbittorrent
    hostname: qbittorrent
    # …

Start this container and point it at your qBittorrent instance with the QBT_HOST environment variable.

$ docker run -d \
    -e "QBT_HOST=http://qbittorrent:8080" \
    jakewharton/qbt-seed-type:1

For Docker Compose, add it as an additional service:

services:
  qbt-seed-type:
    container_name: qbt-seed-type
    image: jakewharton/qbt-seed-type:1
    restart: unless-stopped
    environment:
      - "QBT_HOST=http://qbittorrent:8080"

If you have a non-default username or password, specify the QBT_USER and/or QBT_PASS environment variables, respectively.

The container will check all of your torrents every 5 minutes by default. To change when it runs, specify the CRON environment variable with a valid cron specifier. For help creating a valid cron specifier, visit cron.help.

The 'Solo-seed' and 'Cross-seed' tags will be used by default. To change it, specify your desired tag name in the QBT_SOLO_TAG or QBT_CROSS_TAG environment variable.

To be notified when sync is failing visit https://healthchecks.io, create a check, and specify the ID to the container using the HEALTHCHECK_ID environment variable.

LICENSE

MIT. See LICENSE.txt.

Copyright 2021 Jake Wharton