Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
105 changes: 105 additions & 0 deletions README.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
[🇨🇳 简体中文](README.md) | [🇺🇸 English](README.en.md)

# BitTorrent Tracker Aggregation Project

[![Update Status](https://github.com/adysec/tracker/workflows/Daily%20Update%20Tracker/badge.svg)](https://github.com/adysec/tracker/actions)
[![License](https://img.shields.io/github/license/adysec/tracker)](LICENSE)

## 📖 Overview

This project automatically collects, tests, and maintains high-quality BitTorrent tracker server lists.
Through a daily automated workflow, it aggregates tracker data from multiple open-source projects, performs connectivity tests, and provides curated lists categorized by protocol.

**We provide a recommended tracker endpoint. By using load-balancing based on the full tracker list from this project, you can effectively join all trackers in this project while significantly reducing concurrent requests to individual tracker servers.**

`https://tracker.adysec.com/announce`



## 📋 Tracker Lists

This project provides two types of tracker lists: **full** and **best**.

- The **full list** contains all aggregated tracker servers from upstream open-source projects and is suitable when you want maximum coverage.
- The **best list** is strictly filtered by connectivity tests to keep only truly available, high-quality trackers, giving you the best download experience.

To support different use cases, the best list is further categorized by protocol.
You can select the appropriate protocol type based on what your BitTorrent client supports and your network environment.

- `trackers_best.txt` is the **recommended** option.
It includes high-quality trackers of all supported protocols and offers the best compatibility.
- All lists provide both a primary and a backup download source to ensure high availability.

| Type | Protocol | Description | Primary | Backup |
|------|----------|-------------|---------|--------|
| **Full** | All | All aggregated tracker servers (no availability filtering) | [`trackers_all.txt`](https://down.adysec.com/trackers_all.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_all.txt) |
| **Best** | All | Connectivity-tested, high-quality trackers (recommended) | [`trackers_best.txt`](https://down.adysec.com/trackers_best.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best.txt) |
| **Best** | HTTP | Only available HTTP trackers | [`trackers_best_http.txt`](https://down.adysec.com/trackers_best_http.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_http.txt) |
| **Best** | HTTPS | Only available HTTPS trackers | [`trackers_best_https.txt`](https://down.adysec.com/trackers_best_https.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_https.txt) |
| **Best** | UDP | Only available UDP trackers | [`trackers_best_udp.txt`](https://down.adysec.com/trackers_best_udp.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_udp.txt) |
| **Best** | WSS | Only available WSS trackers | [`trackers_best_wss.txt`](https://down.adysec.com/trackers_best_wss.txt) | [`GitHub`](https://raw.githubusercontent.com/adysec/tracker/main/trackers_best_wss.txt) |

### ✨ Key Features

- 🛡️ **Secure & Reliable** – Integrates threat intelligence and automatically filters malicious IPs
- 🔄 **Daily Updates** – Tracker lists are refreshed every day to keep them up-to-date
- 📊 **Protocol-Aware** – Supports HTTP, HTTPS, UDP and WSS categorized lists
- 🚀 **High Availability** – Only retains trackers that pass connectivity checks
- 🌐 **Multi-Source Aggregation** – Aggregates tracker resources from 10+ well-known open-source projects

## 🔧 Usage

### Configure in BitTorrent Clients

1. **qBittorrent**
*Tools → Options → BitTorrent → Automatically add these trackers to new downloads → paste the list URL*

2. **Transmission**
*Preferences → Trackers → Add tracker URL*

3. **Other Clients**
Add any of the above URLs in the tracker configuration section.

### Command-Line Usage

```bash
# Get the latest recommended tracker list
curl -s https://down.adysec.com/trackers_best.txt

# Get trackers for a specific protocol (e.g., UDP)
curl -s https://down.adysec.com/trackers_best_udp.txt
```

### 🔧 Custom Filtering
Create a blackstr.txt file to filter specific IP addresses or domains:

```bash
# Example: filter malicious IP / domain
echo "192.168.1.100" >> blackstr.txt
echo "malicious-tracker.com" >> blackstr.txt
```

## 📊 Data Sources

This project aggregates tracker resources from the following high-quality open-source projects:

- ngosang/trackerslist
- XIU2/TrackersListCollection
- chenjia404/CnTrackersList
- hezhijie0327/Trackerslist
- DeSireFire/animeTrackerList

## 💡 Motivation

Many public trackers perform poorly in real-world use and severely degrade download experience.
This project aims to automatically aggregate, test, and filter trackers to provide a truly usable, frequently updated list for both personal use and the community.

By leveraging DHT and various tracker information flows, we can collect more torrent metadata (similar to BTDigg) to search and organize useful content.
However, most public torrents are concentrated in adult content, making it difficult to find valuable resources 🐶.

Any tracker naturally logs clients’ IP and port information, which has threat-intelligence value.
For example, you can observe which countries or regions a torrent is most frequently downloaded from, or quickly estimate the location and impact scope in a data-leak incident based on connection distribution.

## ⭐ Star History

If this project is helpful to you, please consider giving it a ⭐ on GitHub!
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
[🇨🇳 简体中文](README.md) | [🇺🇸 English](README.en.md)
# BitTorrent Tracker 聚合项目

[![更新状态](https://github.com/adysec/tracker/workflows/Daily%20Update%20Tracker/badge.svg)](https://github.com/adysec/tracker/actions)
Expand Down