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.3.tar.gz (6.0 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.3-py3-none-any.whl (6.8 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for trackersremoverqbt-0.2.3.tar.gz
Algorithm Hash digest
SHA256 7cc3db9bc016ee48f0945888339bc990ecc4d4c48976e07dd9ee16a5a776d022
MD5 543158b25454bf240fbd68dd018e3c3f
BLAKE2b-256 49d86bea40b46a0b1a0e16dabc720c57cdc8004e8f93e2e60aa3fb70cf645a04

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for trackersremoverqbt-0.2.3-py3-none-any.whl
Algorithm Hash digest
SHA256 c7627d2d55966debe8a1d479231d91ecb08de0cc463e79e2f38dce1096f44bcb
MD5 9c9895a8cb50fd3150bd17023e3952e1
BLAKE2b-256 f04a9a9b7c9600374183cf5831a7919d6e802f5dfaaedae6351fac7b97ae0711

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