Web interface
The web interface is served by heron-web on HERON_HTTP_PORT (8000). Everything it does goes through the API, so scripts can do the same.
| Page | What it is for |
|---|---|
| On air | Decks A and B, levels, skip, pause, the FX player, the next tracks, outputs and the engine’s state |
| Queue | The waiting tracks with their start times: reorder, play next, remove, add, autofill on or off |
| History | Every play by day, and how it ended |
| Tracks | The library: search, filters, columns; act on a selection (queue, label, categorize, edit tags, delete) |
| Buffer | Upload new music, check and prepare it, then import it |
| Trash | Deleted tracks: restore or empty |
| Track | Waveform and cue points, crossfade overrides, categories, labels, details, plays |
| Artists | Names, merges, similar artists, suggestions |
| Clocks, Schedule | Build clocks and paint the week |
| Labels, Categories, Restrictions | Organize tracks and set hard rules |
| Selection log | Why each track was picked; simulations |
| Review & organize | Identifications to review, library organization, undo |
| Crossfade & loudness | Station transitions and loudness, with a live preview |
| Outputs | Encoder profiles and outputs, with their live state |
| Settings | Autofill, rotation, time zone, programming, library, analysis |
| Users | Accounts and roles |
| Account | Theme, language, password, API tokens |
| Role | Can |
|---|---|
| Viewer | See every page except users, without the controls |
| Operator | Run the station: queue, transport, FX, track overrides and categories, clocks, schedule, restrictions, artists, simulations, review |
| Admin | Everything, including playout and library settings, organizing the library, outputs and users |
Every page shows a banner when something needs attention: the API, the database or the engine unreachable, live updates disconnected, or the server clock out of sync.
Live updates
Section titled “Live updates”The interface keeps a WebSocket open: decks, queue and outputs change as soon as the engine reports them, and levels arrive ten times a second. It reconnects by itself.
Every time is shown in the station’s time zone, whatever the browser’s, so the history, the queue, the schedule and the selection log agree.
Themes and languages
Section titled “Themes and languages”Light and dark themes, in English or French. System (the default) follows the device; a fixed choice is saved with your account.
Phones
Section titled “Phones”The layout works from phone width up: the navigation moves to a menu, tables drop secondary columns and cards stack.