spill / docs

Quickstart

This assumes spill serve is running with the default socket (see Install). Add --socket PATH to every spill command if you configured a different control_socket.

Add torrents

spill add ~/Downloads/debian.iso.torrent
spill add 'magnet:?xt=urn:btih:…&tr=udp://tracker.example:1337/announce'
spill add movie.torrent --output /srv/media/incoming

add prints the torrent’s ID: its info hash in hex. Anywhere an ID is expected you can use any unambiguous prefix of it.

Watch progress

spill list            # one line per torrent
spill list --watch    # refresh every second; Ctrl-C to stop
spill get 3f2a        # everything about one torrent, including peers and trackers
spill --json get 3f2a # the same as JSON

A torrent moves through starting, metadata (magnets only), recovering, downloading and seeding. See Torrents for every state.

Control torrents

spill pause 3f2a
spill resume 3f2a
spill set 3f2a upload_limit=1048576 seed_ratio=2
spill files 3f2a
spill set 3f2a 'file_priorities=["high","skip","normal"]'
spill recheck 3f2a
spill remove 3f2a                    # keep downloaded files
spill remove 3f2a --delete-payload   # also delete files Spill created

Use the web interface

Add to your config and restart:

web_listen = "127.0.0.1:8080"

Then open http://127.0.0.1:8080. The page shows progress, rates, ratios and errors, adds torrents and magnets, and edits settings and file priorities. See Web interface and HTTP API.