Skip to content
RelayTVRelayTV Docs

First playback

Open RelayTV

Section titled “Open RelayTV”

Visit the Web UI from another device on the same network:

http://YOUR_RELAYTV_HOST:8787/ui

If it does not load, verify container health before changing display settings:

Terminal window
cd ~/relaytv
docker compose ps
curl -fsS http://127.0.0.1:8787/health

Play and queue

Section titled “Play and queue”
  1. Paste a media URL and select Play now.
  2. Confirm playback begins on the attached display.
  3. Add a second URL with the smart/queue action.
  4. Confirm it appears in Up next without interrupting current playback.
  5. Test play, pause, seek, next, and volume from the browser.

Add one optional integration

Section titled “Add one optional integration”

Start with one control surface or media source so failures remain easy to isolate:

Do not expose port 8787 publicly as a convenience shortcut. Read Security and network first.