Skip to content

Fetching VODs

github-actions[bot] edited this page Nov 21, 2026 · 2 revisions

Fetching VODs

clippa fetch <url> turns a finished broadcast into a stream, whatever the platform; the rest of the pipeline (clippa run) is the same.

URL Stream id Video Chat
kick.com/<channel>/videos/<id> kick-<livestream id> HLS, [kick] max_height chat history
twitch.tv/videos/<id> twitch-<id> yt-dlp, [twitch] max_height chat replay
youtube.com/watch?v=<id>, youtu.be/<id>, youtube.com/live/<id> youtube-<id> yt-dlp, [youtube] fetch_max_height live-chat replay, if the video has one

--no-video pulls the details and chat only; --no-chat the video only. A rerun keeps what is already there.

Which show it belongs to

The stream's channel (a Twitch login, a YouTube handle without the @, a Kick slug) must be in a show's channels list in clipper.toml, or the stream belongs to no show. Add it first (Adding a show).

Notes

  • Twitch chat takes about 5 minutes for a 3-hour VOD: Twitch serves a minute or so of messages per request. A subscriber-only VOD needs the cookies of a signed-in browser as a Netscape cookies.txt; save it as secrets/twitch_cookies.txt (or set [paths] twitch_cookies); no file means none. clippa doctor checks it. Never commit it. The chat comes from Twitch's own web query, which Twitch can change (a burst of more than one page of messages in a single second keeps only its first page); a pull that stops says so and a rerun resumes.
  • YouTube age and bot checks retry once signed in, as in YouTube sign-in. A normal upload has no chat; the stream then has none, and the chat signals simply have nothing to score.
  • Live recording is Kick only (NAS recorder).

Clone this wiki locally