taurus

taurus is a Rust command-line BitTorrent client built around a small, testable architecture and real-world interoperability work.

Current capabilities:

• .torrent downloads
• magnet downloads
• HTTP, HTTPS, and UDP trackers
• single-file and multi-file torrents
• piece verification and on-disk writes
• web-seed fallback
• basic resume from already-verified on-disk pieces
• bounded post-download seeding
• verbose interoperability diagnostics

Current limitations:

• peer-only magnet bootstrapping is still less reliable than mature clients
• no DHT
• no PEX
• no uTP
• no encryption
• no rate limiting
• no GUI or TUI

Usage

Download from a .torrent:

cargo run -- download ./example.torrent --out ./downloads

Download from a magnet:

cargo run -- magnet 'magnet:?xt=urn:btih:...' --out ./downloads

Enable diagnostics:

cargo run -- download ./example.torrent --out ./downloads --verbose

Seed briefly after completion:

cargo run -- download ./example.torrent --out ./downloads --seed-seconds 60

Development

Local checks:

cargo fmt --check
cargo check
cargo test
cargo clippy --all-targets --all-features -- -D warnings

Additional project docs:

• Architecture
• Testing
• Interoperability Backlog

Helper scripts:

• scripts/check-interop-tools.sh

Notes

• Use this project only with legal torrents and content you are authorized to download.
• Licensed under MIT OR Apache-2.0.