Skip to main content

Overview

The BitTorrent community has built various tools to integrate TrackersList with popular clients and workflows. These tools automatically fetch and add trackers to your torrents or client configurations.
These are third-party projects maintained by their respective authors, not by the TrackersList maintainer.

BitTorrent Client Integrations

Tools designed to automatically add TrackersList trackers to specific BitTorrent clients.

Deluge

deluge-default-trackers

Plugin for DelugeAutomatically adds TrackersList trackers to all new torrents in Deluge.
Author
string
stefantalpalaru
Client
string
Platform
string
Linux, Windows, macOS
Language
string
Python
Installation:
git clone https://github.com/stefantalpalaru/deluge-default-trackers.git
cd deluge-default-trackers
python setup.py install

Transmission

Multiple community scripts for adding trackers to Transmission:

transmission-trackers

Python script for TransmissionFetches TrackersList and adds trackers to all active torrents via RPC.
Author
string
blind-oracle
Client
string
Language
string
Python
Features
  • Automatic RPC connection
  • Configurable update intervals
  • Daemon mode support
Usage:
python transmission-trackers.py --host localhost --port 9091

tracker-add

Bash script for TransmissionSimple bash script to add TrackersList trackers to Transmission.
Author
string
AndrewMarchukov
Client
string
Language
string
Bash
Platform
string
Linux, macOS
Usage:
./tracker-add.sh

transmission tracker updater

Alternative bash script for TransmissionAnother bash-based approach to adding trackers to Transmission.
Author
string
oilervoss
Client
string
Language
string
Bash
Usage:
bash update-trackers.sh

add-transmission-trackers.sh

Comprehensive bash script for TransmissionPart of a larger scripts collection, includes robust error handling.
Author
string
Jorman
Client
string
Language
string
Bash
Features
  • Configurable list selection
  • Backup existing trackers
  • Verbose logging
Usage:
./add-transmission-trackers.sh

qBittorrent

add-qbittorrent-trackers.sh

Bash script for qBittorrentAdds TrackersList trackers to qBittorrent via Web UI API.
Author
string
Jorman
Client
string
Language
string
Bash
Platform
string
Linux, macOS
Requirements
qBittorrent Web UI enabled
Usage:
# Configure credentials first
export QB_USER="admin"
export QB_PASS="adminpass"
./add-qbittorrent-trackers.sh

aria2

Multiple tools for integrating TrackersList with aria2:

aria2-trackers

Go script for aria2Automatically updates aria2 configuration with TrackersList trackers.
Author
string
rocket049
Client
string
Language
string
Go
Features
  • Automatic configuration updates
  • RPC support
  • Scheduled updates
Installation:
go install github.com/rocket049/aria2-trackers@latest
Usage:
aria2-trackers --config ~/.aria2/aria2.conf

aria2 tracker Gist

Bash script for aria2Simple bash script that updates bt-tracker setting in aria2.conf.
Author
string
HaleTom
Client
string
Language
string
Bash
Usage:
bash update-aria2-trackers.sh /path/to/aria2.conf

aria2c_TrackersList

Alternative bash script for aria2Another implementation with additional features.
Author
string
wuyuansushen
Client
string
Language
string
Bash
Features
  • Backup old configuration
  • List selection (best/all)
  • Auto-restart aria2
Usage:
./update_tracker.sh

Torrent File Editors

Tools to add TrackersList trackers directly to .torrent files.

bittorrent-tracker-editor

bittorrent-tracker-editor

Standalone .torrent file editorDesktop application to add, remove, or modify tracker lists in .torrent files.
Author
string
GerryFerdinandus
Type
string
Desktop Application
Platform
string
Windows, Linux, macOS
Features
  • Drag-and-drop interface
  • Batch editing
  • TrackersList integration
  • Preview changes before saving
Features:
  • Load TrackersList directly into torrent files
  • Remove duplicate or dead trackers
  • Batch process multiple .torrent files
  • Preserve torrent file structure
Installation:
git clone https://github.com/GerryFerdinandus/bittorrent-tracker-editor.git
cd bittorrent-tracker-editor
npm install
npm start

Online Tools

Web-based tools that don’t require installation.

TorrentEditor

Online .torrent file editorWeb-based tool to edit .torrent files in your browser.
Type
string
Web Application
Features
  • No installation required
  • Add TrackersList trackers
  • Edit torrent metadata
  • Private flag toggle
  • Client-side processing (files never uploaded)
How to Use:
  1. Visit torrenteditor.com
  2. Upload your .torrent file
  3. Add TrackersList URL in the tracker field
  4. Download modified .torrent file
Files are processed locally in your browser - nothing is uploaded to servers

Magnets

Magnet link editorAdd trackers to magnet links directly in your browser.
Type
string
Web Application
Features
  • Paste magnet link
  • Add TrackersList trackers
  • Clean up duplicate trackers
  • Copy enhanced magnet link
How to Use:
  1. Visit madeby.lynx.pink/magnets
  2. Paste your magnet link
  3. Select TrackersList preset
  4. Copy the enhanced magnet link
Example:
Original:
magnet:?xt=urn:btih:ABC123...

Enhanced:
magnet:?xt=urn:btih:ABC123...&tr=udp://tracker.opentrackr.org:1337&tr=...

Tools by Category

By Language

deluge-default-trackers

Plugin for Deluge - automatically adds trackers

transmission-trackers

Transmission RPC integration script

By Client

deluge-default-trackers

Official plugin for Deluge
  • Automatic tracker addition
  • Configurable list selection
  • Works with all Deluge versions 2.0+

Building Your Own Tool

Quick Integration Guide

Want to build your own TrackersList integration? Here’s how:
1

Choose a Mirror

Select the most appropriate mirror for your use case:
const MIRRORS = [
  'https://cdn.jsdelivr.net/gh/ngosang/trackerslist@master/trackers_best.txt',
  'https://ngosang.github.io/trackerslist/trackers_best.txt',
  'https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_best.txt'
];
2

Fetch the List

Download and parse the tracker list:
Python Example
import requests

def fetch_trackers():
    url = 'https://cdn.jsdelivr.net/gh/ngosang/trackerslist@master/trackers_best.txt'
    response = requests.get(url)
    response.raise_for_status()
    
    # Split by blank lines
    trackers = [line.strip() for line in response.text.split('\n') if line.strip()]
    return trackers
3

Integrate with Your Client

Add trackers using your client’s API or configuration format
4

Implement Caching

Cache locally and refresh daily to respect rate limits
5

Handle Errors

Implement failover and graceful degradation

Code Examples

import requests
import json
from datetime import datetime, timedelta

class TrackersListClient:
    def __init__(self, cache_file='trackers_cache.json'):
        self.cache_file = cache_file
        self.mirrors = [
            'https://cdn.jsdelivr.net/gh/ngosang/trackerslist@master/trackers_best.txt',
            'https://ngosang.github.io/trackerslist/trackers_best.txt',
            'https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_best.txt'
        ]
    
    def get_trackers(self, list_name='trackers_best', force_refresh=False):
        # Check cache
        if not force_refresh:
            cached = self._load_cache()
            if cached:
                return cached
        
        # Fetch from mirrors with failover
        for mirror in self.mirrors:
            try:
                url = mirror.replace('trackers_best.txt', f'{list_name}.txt')
                response = requests.get(url, timeout=10)
                response.raise_for_status()
                
                trackers = [line.strip() for line in response.text.split('\n') if line.strip()]
                self._save_cache(trackers)
                return trackers
            except requests.RequestException:
                continue
        
        raise Exception('All mirrors failed')
    
    def _load_cache(self):
        try:
            with open(self.cache_file, 'r') as f:
                data = json.load(f)
                timestamp = datetime.fromisoformat(data['timestamp'])
                if datetime.now() - timestamp < timedelta(hours=24):
                    return data['trackers']
        except (FileNotFoundError, KeyError, ValueError):
            pass
        return None
    
    def _save_cache(self, trackers):
        with open(self.cache_file, 'w') as f:
            json.dump({
                'timestamp': datetime.now().isoformat(),
                'trackers': trackers
            }, f)

# Usage
client = TrackersListClient()
trackers = client.get_trackers()
print(f'Fetched {len(trackers)} trackers')

Contributing Your Tool

Built a TrackersList integration? Share it with the community!
1

Open a GitHub Issue

Submit your tool to the TrackersList repository
2

Include Details

Provide:
  • Tool name and description
  • GitHub repository link
  • Language/platform
  • Which client(s) it supports
  • Installation/usage instructions
3

Get Listed

If approved, your tool will be added to the README and this documentation
Make sure your tool respects rate limits and implements proper caching!

Additional Resources

API Endpoints

Learn about all available tracker lists

Mirror Infrastructure

Choose the best mirror for your tool

Integration Guide

Step-by-step client integration

Contributing

Submit your own tool

Build docs developers (and LLMs) love