MANUAL · 05

Admin & settings.

For the operator running the station. The admin console is where you shape the DJ, choose the AI providers, schedule shows, and manage the jingles — no redeploy required.

SIGNING IN

The admin console.

The console lives at /admin. It's gated by a single sign-in — the ADMIN_USER and ADMIN_PASS set when the station was installed. In production those credentials are mandatory: the station won't start without them, because the admin surface reveals too much to leave open.

Behind the gate are three views — the console itself, /admin/settings, and /admin/debug.

SETTINGS

Tuning the station.

Settings are saved durably and take effect without a redeploy — most apply to the next thing the DJ says. The main things you'll touch:

DJ personas — the roster of souls (1–10), each with a name and character. The DJ picks one at random per spoken moment.
DJ frequency — quiet, moderate, or aggressive: how often the DJ talks, IDs the station, and reads the time and weather.
LLM provider — which model writes the DJ's words and picks tracks. Ollama on your own hardware by default, or a hosted provider (Anthropic, OpenAI, Google, and others) with an API key. Switching reroutes every call immediately.
Voice (TTS) — which text-to-speech engine and voice the DJ speaks with, optionally a different one per kind of segment.
Shows schedule — paint named shows onto a weekly grid; the DJ runs each as its own session.
Mix settings — crossfade length and how often a jingle plays between tracks.

MIX CHANGES NEED A MIXER RESTART

Crossfade and jingle-ratio changes are read by the audio mixer only at startup. The settings page can trigger that restart for you — the stream drops for a few seconds and comes back with the new values applied.

JINGLES

Station idents.

Jingles are short pre-rendered TTS stingers the station rotates between music tracks. The admin console manages the set — adding, removing, and re-rendering them through the configured voice. A fresh install ships with none until you generate them; after that, new renders are picked up automatically.

WHEN SOMETHING'S OFF

The debug view.

/admin/debug is a live snapshot for diagnosing the station — recent AI calls, the mixer's status, and the most recent log lines. It's the first place to look if the stream stalls or the DJ goes quiet.

Installing or updating the station rather than tuning it? That's covered in the setup guide.