Local API: the player’s control surface
The local API is a small HTTP service bound to 127.0.0.1:7680. It
is the single source of truth on the device:
- Exposes
/device for identity and pairing information.
- Exposes
/player/playlist so the playback loop can fetch the
current playlist as JSON.
- Runs
/player/sync to contact the HexitHive portal, pull down
new configs and download media into the local cache.
Playback loop and media engine
The playback loop is intentionally simple: it reads a playlist JSON from the
local API, then hands each digital signage item to mpv in full-screen mode:
- Video items are played for a defined duration or until completion.
- Image items are displayed for their configured duration.
- Any missing or corrupt files are skipped, so one bad asset does not
take the whole loop down.
Local cache & offline safety
All media is cached under /var/lib/hexithive/content. If the
internet connection or the portal is unavailable, the HexitHive Player simply
continues using the last good playlist and local media until it can sync again.