← Docs

First-Time Setup

Everything needed to go from a fresh Pantheon install to a channel that actually plays something — in roughly the order you'll hit it.

💡 Hades walks you through most of this automatically. The first admin account gets a guided tour — a small floating indicator plus an on-page spotlight — that highlights the exact button for steps 1, 2, 3, and 5 below as you go. This page is here for reference, or if you'd rather read ahead before touching the UI.

1Add a media source

Go to Sources → + Add Source. Pantheon supports:

Source type	Auth
Plex	Server URL + token (Account → Troubleshooting → XML)
Jellyfin	Server URL + API key + user ID
Emby	Server URL + API key + user ID
Local	Mount path — no auth needed

Enter the connection details and run Test Connection before saving. After saving, select the source and add the libraries you want Kairos to know about (TV Shows, Movies).

2Configure scraper API keysoptional

Go to Settings → Scrapers. Add a key for whichever metadata sources apply to your library:

Source	Where to get a key
TMDB	themoviedb.org/settings/api — free, instant
TVDB	thetvdb.com/dashboard/account/apikeys — free, requires a TheTVDB account
AniDB	Your registered AniDB client name, for anime libraries

Enable each one and Save Scraper Settings. This is what turns raw filenames into real titles, artwork, and descriptions once you sync — skip it and content still plays fine, just unmatched.

3Sync your library

Back on Sources, hit Sync on the source you added. Kairos scans in the files and (if scraper keys are configured) matches them against TMDB/TVDB/AniDB. Large libraries take a few minutes — progress is visible in Activity. Anything that doesn't match confidently lands in Review for a manual pick.

4Set the path mapif needed

Your media server reports file paths from its own point of view (e.g. /data/TV/...). If your media is mounted at a different path inside the Kairos container (e.g. /media), add a map under Sources → your source → Path Maps so the transcoder can actually find the files:

/data  →  /media

5Create a channel

Channels → + Add Channel. Give it a name, number, and timezone.

6Add a block and preview the EPG

Open the channel, click Add Block. Choose days, a start time, and a block type, then add a show or movie list to it. Click Preview to see the resolved grid — what plays when, with filler patching the gaps — and adjust priority/timing until it looks right. Save Channel locks it in.