Main purposes of this script are forcing private torrents to always seed and tagging those torrents with given tag name to organize. Project is very basic so feel free to contribute if you find any errors or improvements. New ideas are always welcome, too.

This script uses Python client implementation for qBittorrent's Web API by rmmartin16.

• Adds tag to private torrents.
• Force starts the private torrents.
• Activates super-seed mode if you are the only one who is seeding that particular torrent.

You can run the container and automatically remove the container when it exits with:

docker run --rm \
  --name=qbittorrent-tagger \
  -e QB_HOST=192.168.0.254 \
  -e QB_PORT=8080 \
  -e QB_USER=admin \
  -e QB_PASS=password \
  -e QT_FORCE_START=True `# Optional` \
  -e QT_ADD_TAG=True `# Optional` \
  -e QT_REMOVE_TAG=False `# Optional` \
  -e QT_SUPER_SEED=False `# Optional` \
  -e QT_TAG_NAME=Private `# Optional` \
  -e QT_DEBUG=False `# Optional` \
  jaw3l/qbittorrent-tagger:latest

You can build docker image with docker build -t jaw3l/qbittorrent-tagger:latest .

version: "2"

services:
  qbittorrent-tagger:
    image: jaw3l/qbittorrent-tagger:latest
    container_name: qbittorrent-tagger
    environment:
      ## qBitTorrent Information
      - QB_HOST=localhost
      - QB_PORT=8080
      - QB_USER=admin
      - QB_PASS=password
      ## Booleans
      - QT_FORCE_START=False # Optional
      - QT_ADD_TAG=True # Optional
      - QT_REMOVE_TAG=False # Optional
      - QT_SUPER_SEED=True # Optional
      ## Tag Name
      - QT_TAG_NAME=Private # Optional
      ## Debug Mode
      - QT_DEBUG=False # Optional

To start the container and delete afterwards:

docker-compose run --rm qbittorrent-tagger

You can build docker image with docker-compose build than start the container with docker-compose run --rm qbittorrent-tagger

qbittorrent-api module is required for this script to run.

pip3 install -r requirements.txt

You can start the script after you edit the src/settings.py file.

nano src/settings.py 

Save (CTRL+O) than exit (CTRL+X) from nano. Now you are ready to start the python script.

python3 tagger.py

Or you can use pipenv, too

pip3 install pipenv
pipenv install
pipenv run python tagger.py

• Add management option (force start torrents with <=2 seeds)
• Add more options
• Code improvements

What is super-seed?

Super Seeding is a special optimised seeding mode. It allows seeders who are the only seed in the swarm to solely seed pieces that are found nowhere else in the swarm. It works something like this: the superseeding client pretends not to be a seed, but pretends to be a peer with an incomplete file. Then the client shares each piece with one peer only. And that peer can then share that piece with the swarm. This allows the superseeding client to maximise the efficiency of the upload by only sharing those pieces nobody else has. And because of some other things about the behaviour of superseeding, this function does not work at all well in swarms with one peer and one seed only. So it is only good when the seeder is the only seed (usually the original uploader), and there are more than two peers.