Docs

Self-host in ten minutes

One FastAPI server records; the native app watches. Everything below runs on your own hardware. Source is cloned unmodified from GitHub.

Requirements

iPhone, iPad or Mac (macOS 14+) for the app - TestFlight or the GitHub release
Docker, or Python 3.12, for the server - a NAS, a Mac mini, a spare PC
A Twitch account, linked once from Setup → Twitch
Disk space: budget roughly 3 GB per hour of 1080p60 recording

1 · Run the server

$ docker pull image:latest
$ docker compose up -d --build
$ curl -s http://localhost:8000/v1/status

Without Docker, from the repo: cd server && make vendor && make run. Persist ./data/ and GLITCHO_MASTER_KEY. Losing the key loses recordings.

2 · Install the app

Grab the TestFlight build or the Catalyst package from the download page. First launch pairs with your server - QR code, pairing code, or Bonjour on the LAN.

https://your-server.local:8000

3 · Link Twitch and set rules

On a self-hosted engine the admin UI is at /login. Setup → Twitch captures a session (browser login or cookie). Settings → Recording sets auto-record rules - per channel or for everything you follow - plus quality and retention. Notifications fire when a recording starts or finishes.

Troubleshooting

The app can't reach the server

Check the port mapping and that both machines share a network. curl http://your-server.local:8000/v1/status should return JSON with a version.

Recordings stop mid-stream

Usually disk: check the storage bar in Settings. The server pauses new recordings under 5% free space. Keep the master key stable across upgrades.

Chat replay is empty

Chat capture starts with the recording - VODs imported from elsewhere have no chat log to replay.

Full install notes live in server/INSTALL.md on GitHub.