Skip to main content
Integrate TrackersList with qBittorrent using community-maintained bash scripts that automatically update trackers for all your torrents.

​
Overview

The qBittorrent bash script fetches the latest tracker list and adds them to all active torrents in your qBittorrent client. This ensures your torrents always have access to the most up-to-date and best-performing trackers.

​
Prerequisites

Before you begin, ensure you have:
  • qBittorrent installed and running
  • Bash shell (Linux, macOS, or WSL on Windows)
  • curl or wget for downloading tracker lists
  • Access to qBittorrent’s Web UI (recommended for automation)

​
Integration Script

​
Available Tools

The community maintains a bash script specifically for qBittorrent:

addqbittorrenttrackerssh

Bash script by Jorman that adds TrackersList trackers to qBittorrent

​
Installation

1

Download the script

Clone the repository or download the script directly:
git clone https://github.com/Jorman/Scripts.git
cd Scripts
Or download the specific script:
wget https://raw.githubusercontent.com/Jorman/Scripts/master/addqbittorrenttrackerssh
chmod +x addqbittorrenttrackerssh
2

Configure qBittorrent Web UI

Enable the Web UI in qBittorrent:
  1. Open qBittorrent
  2. Go to Tools > Options > Web UI
  3. Check Web User Interface (Remote control)
  4. Set a username and password
  5. Note the port (default: 8080)
  6. Click OK to save
3

Edit script configuration

Open the script and configure your qBittorrent connection details:
nano addqbittorrenttrackerssh
Update the following variables:
  • qBittorrent Web UI URL
  • Username and password
  • Tracker list URL (use TrackersList URL)
4

Run the script

Execute the script to add trackers:
./addqbittorrenttrackerssh
The script will fetch the latest tracker list and add them to all torrents in qBittorrent.

​
Automation

Schedule the script to run automatically using cron for regular tracker updates.

​
Setting up a Cron Job

1

Open crontab editor

crontab -e
2

Add cron entry

Add a line to run the script daily at 3 AM:
0 3 * * * /path/to/addqbittorrenttrackerssh >> /var/log/qbt-trackers.log 2>&1
Or run weekly on Sundays:
0 3 * * 0 /path/to/addqbittorrenttrackerssh >> /var/log/qbt-trackers.log 2>&1
3

Save and verify

Save the crontab file and verify it’s scheduled:
crontab -l
Run the script weekly to keep your tracker list fresh without overwhelming the TrackersList servers.

​
Tracker List Selection

Choose which TrackersList to use in your script: 
# Use the top 20 best-performing trackers
TRACKER_URL="https://raw.githubusercontent.com/ngosang/trackerslist/master/trackers_best.txt"

​
Manual Integration

If you prefer not to use scripts, you can manually add trackers:
1

Get tracker list

Download a tracker list from TrackersList:
2

Open torrent properties

In qBittorrent:
  1. Right-click a torrent
  2. Select Edit trackers
3

Add trackers

Paste the tracker URLs into the tracker list, one per line, and click OK.
4

Apply to all torrents

Repeat for each torrent, or use the Category feature to apply trackers to multiple torrents.
Manual integration requires periodic updates to maintain optimal tracker performance. Consider using the automated script for best results.

​
Troubleshooting

  • Verify the Web UI is enabled and accessible
  • Check username, password, and port in the script
  • Ensure qBittorrent is running
  • Check firewall settings if running on a remote server
  • Verify the tracker list URL is accessible
  • Check script permissions: chmod +x addqbittorrenttrackerssh
  • Review script output for error messages
  • Ensure qBittorrent API is responding correctly
The script may add trackers that already exist. This is usually harmless as qBittorrent handles duplicates, but you can manually remove duplicates through the Web UI or by modifying the script to check for existing trackers first.

​
Additional Resources

qBittorrent Documentation

Official qBittorrent documentation and wiki

Jorman's Scripts

Additional automation scripts for torrent clients

TrackersList Repository

View all available tracker lists and formats

Web UI Guide

qBittorrent Web UI API documentation

Build docs developers (and LLMs) love

Get started for freeTalk to us