A modern torrent client.
Built in Rust.

Run spill as a daemon, or embed its engine in your application.

Linux and macOS · Open source · v0.7.6

Recommended / prebuilt binary
curl -fsSL https://spill.rs/install.sh | sh

Installs to ~/.local/bin. No sudo or Rust toolchain required. Verifies SHA-256 checksums. Inspect installer

Linux x64/ARM64 requires glibc 2.39+ (Ubuntu 24.04 or newer). Apple Silicon requires macOS 11+. Other platforms: build from source.

Other installation methods

For manual installation and checksum verification, see the installation guide.

Install with Cargo
cargo install spill --locked

Requires the Rust toolchain. Installs to Cargo’s binary directory, usually ~/.cargo/bin. spill is not yet available through OS package managers.

Start downloading

Start the daemon
spill serve

Leave it running. In another terminal, add a torrent and watch progress:

Add your .torrent file
spill add /path/to/file.torrent
Watch progress
spill list --watch

Replace /path/to/file.torrent with your file. Downloads go to ~/Downloads by default. If spill is not found, follow the installer’s PATH instructions.

Embed the engine

Use the same engine without a separate daemon or catalog. Your application owns the Tokio runtime, networking policy, persistence, and lifecycle.

Use spill in your Rust application
cargo add spill --no-default-features

Library guide and examples → · Rust API reference ↗ · crates.io/spill ↗

Building with an AI agent? Operation and integration guidance →

Built for real transfers

Capabilities and scope →

Download and seed

BitTorrent v1 torrents and magnets, TCP and uTP peers, trackers, DHT, PEX, and HTTP web seeds.

Control your transfers

File priorities, rate limits, and seeding goals. A CLI, JSON output for automation, and an optional local web interface.

Verify and recover

Only hash-verified pieces are shared. Checkpoints preserve verified progress, with changed files rechecked on restart.