How it works
ReplayVOD downloads media from Twitch and saves it in a shared library. A recording can come from a live stream or an existing Twitch VOD.
Live recordings and archives
Section titled “Live recordings and archives”A live recording captures a stream while the channel is broadcasting. Starting one manually records the current stream; it doesn’t create a rule to record the channel again. A schedule can start recordings automatically for future broadcasts.
An archive downloads a VOD that Twitch still has available. Archives use a separate download queue and appear in the same library as live recordings.
See the Quickstart for the recording steps or Archive VODs for downloading past broadcasts.
Schedules
Section titled “Schedules”A schedule tells ReplayVOD to record one channel. You choose the recording quality and can add category, tag, or minimum-viewer filters. Without optional filters, the schedule matches every stream from that channel.
When a stream matches several schedules, ReplayVOD creates one recording. See Schedules & title tracking for filters and recording settings.
Live detection
Section titled “Live detection”Automatic recording needs a way to detect when channels go live:
- Polling checks Twitch at a regular interval. It works without a public callback URL.
- Direct EventSub receives notifications from Twitch at your server’s public HTTPS callback.
- Connect relay receives those notifications through an outbound connection to a relay.
- Off disables automatic live detection.
Manual recordings and archive downloads don’t require automatic live detection. Connect carries notifications only; the recorder downloads media directly from Twitch and saves it in your configured storage.
See EventSub or Connect relay for setup.
Title tracking
Section titled “Title tracking”ReplayVOD can record title and category changes during a broadcast. The watch page shows them on a timeline so you can jump to a particular change. Tracking uses the same polling or EventSub mode as live detection. See Title tracking.
Recording and storage
Section titled “Recording and storage”The recorder downloads the stream in segments, retries failed downloads, and combines the captured footage into video or audio files. It also generates previews for the dashboard.
Files are saved on a local disk or in S3-compatible storage. The database holds schedules, accounts, recording details, and download progress. ReplayVOD uses that progress to recover interrupted jobs after a restart; footage that is no longer available from Twitch may be missing.
Some streams and qualities require a connected Twitch playback account. See Storage for local and S3 configuration.
Shared library
Section titled “Shared library”People signed in to the same server share its recordings, but each account keeps its own watch progress, watch later list, and favourite channels. Roles control who can manage recordings and server settings. See Users & invitations for permissions and access management.