Quickstart
1. Install
Section titled “1. Install”curl -fsSL https://replayvod.com/install.sh | shThe installer creates ~/replayvod, writes server/.env from the example, generates secrets, prompts for your Twitch credentials, then starts the stack.
Install Docker Desktop, then in PowerShell:
git clone https://github.com/befabri/replayvod.gitSet-Location replayvodCopy-Item server/.env.example server/.envnotepad server/.envdocker compose --env-file server/.env --profile sqlite up -dThis pulls the prebuilt ghcr.io/befabri/replayvod:latest image (add --build to build from source). Fill in TWITCH_CLIENT_ID, TWITCH_SECRET, OWNER_TWITCH_ID, and SESSION_SECRET in server/.env before the docker compose step.
2. Register a Twitch app
Section titled “2. Register a Twitch app”Create an application in the Twitch developer console with this OAuth redirect URL:
http://localhost:8080/api/v1/auth/twitch/callbackCopy the resulting Client ID and Client Secret when the installer asks.
3. Sign in
Section titled “3. Sign in”-
Open http://localhost:8080.
-
Sign in with Twitch.
-
The user listed in
OWNER_TWITCH_IDis granted the owner role.
4. Record your first VOD
Section titled “4. Record your first VOD”-
Follow the channels you want to record on Twitch.
-
In the dashboard, open Schedules and create a rule (quality, optional category or tag filter).
-
The next time a matching stream goes live, ReplayVOD records it.
Where to next
Section titled “Where to next”- How it works — the mental model.
- Configuration — what
server/.envandserver/config.tomlactually control. - Troubleshooting — when something doesn’t.