ttv is a small CLI tool for watching Twitch streams and VODs from the terminal. It integrates with the Twitch API to manage follows, list online channels, and launch playback via streamlink and mpv.
- Manage Twitch API credentials and access tokens
- Follow and unfollow streamers locally (stored in SQLite)
- List followed streamers with online/offline filtering and game info
- Watch live streams or select VODs to play
- Rust (edition 2024) toolchain
streamlinkinstalled and available onPATHmpvinstalled and available onPATH
From source:
git clone git@github.com:vstegen/ttv.git
cd ttv-rs
cargo build --releaseThe binary will be at target/release/ttv (add it to your PATH).
ttv stores its configuration in the XDG config directory:
- Linux/macOS:
~/.config/ttv/config.json - Windows:
%APPDATA%\ttv\config.json
Set your Twitch API credentials:
ttv config --client-id <CLIENT_ID> --client-secret <CLIENT_SECRET>Fetch a new app access token:
ttv authGeneral help:
ttv --helpttv config [--client-id <ID>] [--client-secret <SECRET>] [--access-token <TOKEN>] [--expires-at <RFC3339>] [--show]
ttv auth [--show] [--verbose]
ttv follow [--verbose] <LOGIN...>
ttv list [--status <online|offline|all>]
ttv watch <STREAM...>
ttv vod <LOGIN>
ttv unfollow [--verbose] <LOGIN...>
Follow streamers locally (stored in SQLite):
ttv follow jonhoo theprimeagenList followed streamers (default: online only):
ttv list
ttv list --status all
ttv list --status offlineWatch one or more live streams by login or URL:
ttv watch theprimeagen
ttv watch https://www.twitch.tv/jonhooSelect and watch a VOD for a streamer:
ttv vod theprimeagenRemove local follows:
ttv unfollow theprimeagen jonhoottv stores follows in a local SQLite database:
- Linux/macOS:
~/.local/share/ttv/ttv.sqlite - Windows:
%APPDATA%\ttv\ttv.sqlite
- If Twitch API requests fail, ensure you have a valid client ID/secret and run
ttv auth. - If playback fails, verify that
streamlinkandmpvare installed and on yourPATH. - Twitch ads can cause a black screen during playback. This is a known limitation of Twitch and
streamlink, notttv.