mirror of https://github.com/YGGverse/btracker.git synced 2026-03-31 09:05:30 +00:00

βtracker is a BitTorrent aggregator based on the aquatic-crawler API and Rocket web-framework, written in Rust https://crates.io/crates/btracker

aggregator aquatic aquatic-crawler bittorrent btracker catalog js-less librqbit rocket rust server torrent tracker yggtracker

Find a file

yggverse aa94d1f2d7 update readme		2025-08-12 00:44:16 +03:00
.github	initial commit	2025-08-01 20:04:38 +03:00
public/theme	break-word on long titles	2025-08-11 22:48:48 +03:00
src	add multi-keyword search support	2025-08-12 00:28:16 +03:00
templates	hide pagination totals on empty response	2025-08-11 19:48:00 +03:00
.gitignore	move gitignore rules to the global namespace	2025-08-10 01:18:17 +03:00
Cargo.toml	update version	2025-08-11 19:32:44 +03:00
LICENSE	Initial commit	2025-08-01 18:51:17 +03:00
README.md	update readme	2025-08-12 00:44:16 +03:00

README.md

btracker

βtracker is a social BitTorrent aggregator based on the aquatic-crawler FS API and Rocket web-framework.

Screenshots

See the Wiki page

Live

http://[302:68d0:f0d5:b88d::fdb] - Yggdrasil only peers BitTorrent tracker
- http://tracker.ygg - Alfis DNS alias

Roadmap

Listing (index) page
- Basic metainfo
- Pagination
- Search
  - multiple keyword support [ ] configurable split separators
  - torrent meta match
    - name
    - comment
    - created by
    - publisher
    - publisher URL
    - announce
    - announce list
    - file names
  - relevance ranking
  - fast n-memory index
  - search options form
- results order controls (torrent indexed by default)
Details page
- files
  - clickable content preview
- name
- comment
- created at
- created by
- publisher
- publisher URL
- announce
- announce list
Common features
- scrape peers/seeders/leechers
  - UDP
  - TCP
- download
  - magnet link
  - torrent file
    - from the public location
    - filtered trackers binary
RSS feed

Install

Stable

cargo install btracker

Repository

git clone https://github.com/yggverse/btracker.git && cd btracker
cargo build --release
sudo install target/release/btracker /usr/local/bin/btracker
- copy public & templates folders to the server destination

Usage

btracker --public=/path/to/aquatic-crawler/preload\
         --scrape=udp://127.0.0.1:6969\
         --tracker=udp://[302:68d0:f0d5:b88d::fdb]:6969\
         --tracker=udp://tracker.ygg:6969

The --public argument specifies the location of the crawled torrents (see aquatic-crawler)
- make sure this location also contains a copy (or symlink) of the /public files from this crate (see the Rocket deploying specification)
The --scrape argument is optional and enables statistics for peers, seeders, and leechers
- it is recommended to use the local address for faster performance
- this argument supports multiple definitions for both the IPv4 and IPv6 protocols, parsed from the URL value
- take a look at the --udp option if you want to customize the default binding for UDP scrapes
Define as many --tracker(s) as required
Append RUST_LOG=debug for detailed information output; use --debug to configure as rocket::Config::debug_default()
See the project Wiki for more details (including systemd and nginx examples)

Options

btracker --help