trackers/README.md

Trackers

A torrent tracker aggregator that polls multiple sources and serves a unified, deduplicated list of tracker URLs via HTTP API.

Educational project written in Go 1.25.5

Features

• Polls tracker sources at configurable intervals
• Supports HTTP/HTTPS and local file sources
• Deduplicates and validates tracker URLs
• Persistent disk caching for resilience
• HTTP proxy support via environment variables
• Request logging for monitoring
• Single binary with minimal dependencies

Usage

trackers -config config.toml

Get the aggregated tracker list:

curl http://127.0.0.1:8080/list

Configuration

See config.dist.toml for a complete configuration example with comments.

Copy the example file and customize:

cp config.dist.toml config.toml
# Edit config.toml with your sources

Proxy Support

HTTP requests respect standard proxy environment variables:

export HTTP_PROXY=http://proxy.example.com:8080
export HTTPS_PROXY=http://proxy.example.com:8080
trackers -config config.toml

See config.dist.toml for details.