# 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

```shell
trackers -config config.toml
```

Get the aggregated tracker list:

```shell
curl http://127.0.0.1:8080/list
```

## Configuration

See [config.dist.toml](config.dist.toml) for a complete configuration example with comments.

Copy the example file and customize:

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

## Proxy Support

HTTP requests respect standard proxy environment variables:

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

See [config.dist.toml](config.dist.toml) for details.