Developers
API and Data
Understanding endpoint families and local persistence.
Main Routes
| Prefix | Function |
|---|---|
/api/auth | Status, connection, password, and logout |
/api/search | Remote and local search |
/api/channels | Subscriptions, linked channels, and catalogs |
/api/videos | Metadata, playback, progress, and deletion |
/api/downloads | Queue, actions, and live events |
/api/system | Settings, scanner, cookies, storage, and yt-dlp |
/api/history | Playback and search history |
/api/playlists | Playlists and content |
/api/import | Import of channels or supported data |
/api/health provides availability control. Media is served by dedicated routes with validated paths; never expose data volumes directly.
SQLite operates in WAL mode. The schema includes, among other things, channels, subscriptions, videos, download queue, histories, settings, and playlists. Any migration must remain compatible with an existing database and be accompanied by a restoration test.