webtor-cli

webtor-cli

Command-line client for webtor.io: store torrents, stream or download their content over plain HTTP, manage your library and long-term Vault storage — from the terminal or from scripts.

$ webtor add "magnet:?xt=urn:btih:08ada5a7a6183aae1e09d831df6748d566095a10"
id     08ada5a7a6183aae1e09d831df6748d566095a10
name   Sintel
size   129.2 MB
files  11

$ webtor ls 08ada5a7a6183aae1e09d831df6748d566095a10
$ webtor download 08ada5a7a6183aae1e09d831df6748d566095a10 Sintel.mp4
$ webtor play "magnet:?xt=urn:btih:..."          # straight into VLC
$ webtor url 08ada5a7a6183aae1e09d831df6748d566095a10 Sintel.mp4 | xargs mpv

Torrents, magnets and infohashes pipe straight in — add takes the payload, every other command takes the resource id:

$ cat file.torrent | webtor add
$ curl -sL https://example.com/file.torrent | webtor add
$ echo 08ada5a7a6183aae1e09d831df6748d566095a10 | webtor play
$ some-tool | webtor download --stdout Sintel.mp4 > out.mp4

Install

Homebrew (macOS / Linux):

$ brew install webtor-io/tap/webtor

Prebuilt binaries — grab the archive for your OS/arch from the latest release (darwin / linux / windows, amd64 + arm64), unpack and put webtor on your PATH:

$ curl -sL https://github.com/webtor-io/webtor-cli/releases/download/v1.0.0/webtor_1.0.0_linux_amd64.tar.gz | tar xz webtor
$ sudo install webtor /usr/local/bin/

Docker — the image pairs naturally with the config-less env mode:

$ docker run --rm -e WEBTOR_BACKEND=webui -e WEBTOR_API_KEY=... \
    ghcr.io/webtor-io/webtor-cli:latest info 08ada5a7a6183aae1e09d831df6748d566095a10

From source (Go 1.25+; note the binary lands as webtor-cli):

$ go install github.com/webtor-io/webtor-cli@latest

First run

webtor (or webtor config init) walks you through the setup:

1. webtor.io account (recommended) — logs the terminal in like gh: a one-time code, a browser confirmation on webtor.io, and the CLI gets its own revocable API key. Requires a paid plan.
2. RapidAPI — paste your key from the webtor listing.
3. Self-hosted — point it at your own rest-api base URL.

Configuration lives in ~/.config/webtor/config.yaml. The setup asks for a download folder (default ~/Downloads/webtor; download_dir in the config, WEBTOR_DOWNLOAD_DIR in env mode) — download without -o lands there, and play prefers a complete local copy from that folder over streaming. API keys go to the OS keyring (macOS Keychain, Windows Credential Manager, Linux Secret Service); where no keyring is available they fall back to credentials.yaml (0600). WEBTOR_NO_KEYRING=1 forces the file. Multiple named contexts are supported: --context, webtor config use <name>. CI needs no files at all:

$ WEBTOR_BACKEND=webui WEBTOR_API_KEY=... webtor --json info <hash>

The WEBTOR_* variables configure this config-less mode as a set — they are only read when WEBTOR_BACKEND is set, and never override file contexts.

Commands

Interactive mode (terminal only — scripts keep the old behavior): the screens are arrow-key lists — ↑↓/jk move, the mouse works too (the row under the pointer underlines like a link, click selects, wheel scrolls), typing filters live, Enter selects, Tab marks in multi-select, Esc goes one screen back, Ctrl-C quits. Bare webtor opens the top menu (library / vault / profile); webtor <resource-id> (or a magnet) opens the torrent's action menu — play, browse the file tree (Enter descends, Esc ascends; a torrent's single wrapper folder is skipped), download, library and vault actions in one place; the same menu serves entries picked in the library and vault browsers. The library browser has section (all / movies / series), sort (recent / name, plus year and rating for movies/series) and watched-filter (all / unwatched / watched) toggles, mirroring the web-ui tabs. play asks which file when a torrent has several (Enter = biggest video) and confirms on its own screen; menu downloads run in the background and open the download manager right away; the hint line shows "tab: downloads (N active)" and Tab reaches the manager from anywhere. One torrent downloads at a time — starting it again shows the running task instead of queueing a rival. While a download runs the terminal itself reports it: the tab/window title carries the percentage, and terminals that support the progress escape (Windows Terminal, WezTerm, Ghostty, ConEmu) draw a bar on the tab; a task opens its own pause / resume / abort screen. Paused downloads persist across sessions (running ones are parked as paused on exit) and resume from the bytes on disk. download -i picks files from the list. Piped answers fall back to a numbered prompt (b = back, q = quit); WEBTOR_PLAIN_PICKER=1 forces it. Aliases: dl = download, p = play, lib = library, v = vault, i = info, u = url.

Every command takes --json for machine output; errors then mirror the API's {"error":{"code","message"}} envelope on stderr. Exit codes: 2 usage, 3 auth, 4 payment required, 5 not found, 6 unsupported on this backend, 7 rate-limited/timeout.

Built on api-sdk-go; the API reference lives at https://api.webtor.io/v1/docs/index.html.

License

MIT