Skip to main content

Automatically removes trackers from active qBittorrent downloads.

Project description

TrackersRemover-qBittorrent 🗑️

TrackersRemover-qBittorrent is a Python script that connects to qBittorrent's Web UI and removes trackers from torrents once their download speed exceeds a configurable threshold. This can help improve privacy or reduce reliance on certain trackers.


Features

  • Connects to qBittorrent Web UI via qbittorrent-api.
  • Lists torrents and their trackers.
  • Removes non-ignored trackers from torrents actively downloading above a minimum speed.
  • Configurable ignored trackers list and minimum download speed threshold.

Installation

Install via PyPI

Install the package directly using pip:

pip install trackersremoverqbt

Then simply run it from the command line:

trackersremoverqbt

or

trqbt

Available options:

# Exemple
trackersremoverqbt --host localhost --port 8080 --username admin --password 123456 --verify-webui-certificate True --min-dl-speed 15 --ignored-trackers "tracker1.example.com" "tracker2.example.com"

--host : qBittorrent Web UI address (default: localhost)

--port : Web UI port (default: 8080)

--username : Web UI username (default: admin)

--password : Web UI password (default: 123456)

--verify-webui-certificate : Verify SSL certificate (default: False)

--min-dl-speed : Minimum download speed in KB/s to trigger tracker removal (default: 10)

--ignored-trackers : Additional list of trackers to ignore (default includes DHT, PeX, LSD)

Or manually

  1. Download the script

    Clone this repository or download the TRqBt.py script directly.

  2. Set up Python environment

    Make sure you have Python 3 installed (tested with Python 3.12).

    Install the required packages via pip:

    pip install qbittorrent-api rich
    
  3. Configure the script

  • Open the TRqBt.py file and update the qBittorrent connection settings to match your setup:

    client = Client(
        host="localhost",   # qBittorrent Web UI address
        port=8080,          # Web UI port
        username="admin",   # Web UI username
        password="123456",  # Web UI password
        VERIFY_WEBUI_CERTIFICATE=False
    )
    
  • Optionally adjust the minimum download speed (in KB/s) to trigger tracker removal:

    MIN_DL_SPEED = 10  # Minimum download speed in KB/s
    
  • You can also customize the list of trackers to ignore (default includes DHT, PeX, LSD):

    IGNORED_TRACKERS = {"** [DHT] **", "** [PeX] **", "** [LSD] **"}
    
  • Run the script

    Make sure qBittorrent is running and the Web UI is enabled.

    python TRqBt.py
    

Usage

The script runs in a loop, periodically checking torrents and removing trackers that meet the criteria. It outputs a formatted table of torrents with their trackers and logs removal actions.

Disclaimer

Removing trackers from torrents goes against the principles of traditional P2P sharing. By using this plugin, you acknowledge and agree:

  • You understand the implications of modifying torrent behavior.
  • You are solely responsible for any consequences that arise from using this plugin.
  • The author(s) of TrackersRemover are not responsible for any misuse or unlawful use of this software.

Notes

This tool is intended for advanced users aware of torrenting implications.

Tested on Python 3.12 and qBittorrent Web UI 5.x.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

trackersremoverqbt-0.2.0.tar.gz (4.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

trackersremoverqbt-0.2.0-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file trackersremoverqbt-0.2.0.tar.gz.

File metadata

  • Download URL: trackersremoverqbt-0.2.0.tar.gz
  • Upload date:
  • Size: 4.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.6

File hashes

Hashes for trackersremoverqbt-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a3ea1fa20f89161263cdd44d225e0c9d4d5bc69fe7e88474f4e29914e452c7bd
MD5 9fedce664abab2547cf37bae965c120f
BLAKE2b-256 4da276d3815d12e893a9969b54b6d696542df20f0769d9a66450f783e404dc41

See more details on using hashes here.

File details

Details for the file trackersremoverqbt-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for trackersremoverqbt-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c526276e986fc9d0e034585a786fd35d8dfecf193bafeb6c9cf54892252295ce
MD5 01efc64cb6c733b014c9eed889785372
BLAKE2b-256 9f95e8a5a7118ab769b7ef3b975c5f3819659715f6def3042c7b178a605c42c2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page