# xiu2/trackerslistcollection architecture

> Architecture diagram of the GitHub repository xiu2/trackerslistcollection, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xiu2/trackerslistcollection
- Repository: https://github.com/xiu2/trackerslistcollection

## Overview

This repository is a curated BitTorrent tracker-list collection, not an application with a processing service. Users fetch a list suited to their tracker selection or client format, then add it to their torrent client. The README documents daily updates, public tracker sources, standard and Aria2-formatted lists, and HTTP-filtered lists. The tree and README do not establish how lists are collected, filtered, or transformed, so those implementation links are omitted.

Main entry points: [`best.txt`](https://github.com/xiu2/trackerslistcollection/blob/master/best.txt) (Best list), [`.github/workflows/update-trackers.yml`](https://github.com/xiu2/trackerslistcollection/blob/master/.github/workflows/update-trackers.yml) (Daily update), [`all.txt`](https://github.com/xiu2/trackerslistcollection/blob/master/all.txt) (All list), [`http.txt`](https://github.com/xiu2/trackerslistcollection/blob/master/http.txt) (HTTP(S) list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_maintenance["List maintenance"]
  node_daily_update["Daily update"]
end

subgraph group_lists["Tracker lists"]
  node_best["Best list<br/>[best.txt]"]
  node_all["All list<br/>[all.txt]"]
  node_http["HTTP&#40;S&#41; list<br/>[http.txt]"]
  node_nohttp["No-HTTP list<br/>[nohttp.txt]"]
  node_other["Other list<br/>[other.txt]"]
  node_blacklist["Blacklist<br/>[blacklist.txt]"]
  node_best_aria2["Best Aria2<br/>[best_aria2.txt]"]
  node_all_aria2["All Aria2<br/>[all_aria2.txt]"]
  node_http_aria2["HTTP Aria2<br/>[http_aria2.txt]"]
  node_nohttp_aria2["No-HTTP Aria2<br/>[nohttp_aria2.txt]"]
end

subgraph group_consumption["Client use"]
  node_torrent_client["Torrent client"]
end

node_maintainer(("Curators"))
node_sources["Public tracker sources"]
node_client_user(("Torrent client user"))

node_sources -->|"curated into"| node_best
node_maintainer -->|"maintains"| node_daily_update
node_daily_update -->|"updates daily"| node_best
node_client_user -->|"fetches"| node_best
node_client_user -->|"fetches"| node_all
node_client_user -->|"fetches"| node_http
node_client_user -->|"fetches"| node_nohttp
node_client_user -->|"fetches"| node_other
node_client_user -->|"fetches"| node_blacklist
node_client_user -->|"fetches"| node_best_aria2
node_client_user -->|"fetches"| node_all_aria2
node_client_user -->|"fetches"| node_http_aria2
node_client_user -->|"fetches"| node_nohttp_aria2
node_client_user -->|"configures"| node_torrent_client

click node_daily_update "https://github.com/xiu2/trackerslistcollection/blob/master/.github/workflows/update-trackers.yml"
click node_best "https://github.com/xiu2/trackerslistcollection/blob/master/best.txt"
click node_all "https://github.com/xiu2/trackerslistcollection/blob/master/all.txt"
click node_http "https://github.com/xiu2/trackerslistcollection/blob/master/http.txt"
click node_nohttp "https://github.com/xiu2/trackerslistcollection/blob/master/nohttp.txt"
click node_other "https://github.com/xiu2/trackerslistcollection/blob/master/other.txt"
click node_blacklist "https://github.com/xiu2/trackerslistcollection/blob/master/blacklist.txt"
click node_best_aria2 "https://github.com/xiu2/trackerslistcollection/blob/master/best_aria2.txt"
click node_all_aria2 "https://github.com/xiu2/trackerslistcollection/blob/master/all_aria2.txt"
click node_http_aria2 "https://github.com/xiu2/trackerslistcollection/blob/master/http_aria2.txt"
click node_nohttp_aria2 "https://github.com/xiu2/trackerslistcollection/blob/master/nohttp_aria2.txt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_daily_update,node_client_user toneBlue
class node_best,node_all,node_http,node_nohttp,node_other,node_blacklist,node_best_aria2,node_all_aria2,node_http_aria2,node_nohttp_aria2 toneAmber
class node_torrent_client toneMint
class node_maintainer,node_sources toneIndigo
```

## Components

### List maintenance

- [Daily update](https://github.com/xiu2/trackerslistcollection/blob/master/.github/workflows/update-trackers.yml): `.github/workflows/update-trackers.yml`

### Tracker lists

- [Best list](https://github.com/xiu2/trackerslistcollection/blob/master/best.txt): `best.txt`
- [All list](https://github.com/xiu2/trackerslistcollection/blob/master/all.txt): `all.txt`
- [HTTP(S) list](https://github.com/xiu2/trackerslistcollection/blob/master/http.txt): `http.txt`
- [No-HTTP list](https://github.com/xiu2/trackerslistcollection/blob/master/nohttp.txt): `nohttp.txt`
- [Other list](https://github.com/xiu2/trackerslistcollection/blob/master/other.txt): `other.txt`
- [Blacklist](https://github.com/xiu2/trackerslistcollection/blob/master/blacklist.txt): `blacklist.txt`
- [Best Aria2](https://github.com/xiu2/trackerslistcollection/blob/master/best_aria2.txt): `best_aria2.txt`
- [All Aria2](https://github.com/xiu2/trackerslistcollection/blob/master/all_aria2.txt): `all_aria2.txt`
- [HTTP Aria2](https://github.com/xiu2/trackerslistcollection/blob/master/http_aria2.txt): `http_aria2.txt`
- [No-HTTP Aria2](https://github.com/xiu2/trackerslistcollection/blob/master/nohttp_aria2.txt): `nohttp_aria2.txt`

### Client use

- **Torrent client**

### Other components

- **Curators**
- **Public tracker sources**
- **Torrent client user**

## Connections

- Public tracker sources → Best list: curated into
- Curators → Daily update: maintains
- Daily update → Best list: updates daily
- Torrent client user → Best list: fetches
- Torrent client user → All list: fetches
- Torrent client user → HTTP(S) list: fetches
- Torrent client user → No-HTTP list: fetches
- Torrent client user → Other list: fetches
- Torrent client user → Blacklist: fetches
- Torrent client user → Best Aria2: fetches
- Torrent client user → All Aria2: fetches
- Torrent client user → HTTP Aria2: fetches
- Torrent client user → No-HTTP Aria2: fetches
- Torrent client user → Torrent client: configures
