Tutorials

These pages are walkthroughs: numbered steps, what you should see after each one, and what to do if you do not. They leave the reasons to the rest of the docs. Each step that has a reason behind it links to the page that gives the reason, so read on from there when a step surprises you.

If you only want a station talking between records as fast as possible, Quick start makes every choice for you and is shorter than any of these.

Install it

1. Before you install: what to have ready, and how big a machine.
2. Install the station, either on Unraid or with Docker Compose.
3. Your first hour on air: music, a name, a presenter, and something playing.

Create with AI

The station's own model does some of this from buttons in the console, and Claude connected to the station can do the rest by being asked. Each page shows both where both exist.

1. Give the station a model: a provider, the jobs it does, and connecting Claude if you want it.
2. Write a character: one sentence in, a whole presenter out, auditioned before it airs.
3. Make a show: a block on the timetable with a host and a brief the model programmes against.
4. Make a voice: design one in Claude with ElevenLabs, clone it, and give it to a character.

Grow the station

Each of these adds one thing to a station that is already on air, and none depends on another.

• Add a second music source: a second provider beside the first, and a playlist brought in from either by its link.
• News and weather in the breaks: headlines from your own feeds, a forecast for where the station is, and a bulletin at the top of the hour.
• Carry a podcast: subscribe to a show and give its newest episode a time on the clock.
• Play the station on a speaker: a Chromecast, a Sonos, a BluOS player or a UPnP renderer, started from the Desk.
• Put the station on a chat platform: a bot on Telegram, Discord or Slack that says what is playing, takes requests, and lets you run the station from a chat.
• Light up an On Air sign with Home Assistant: the station telling your own servers what goes on air, so a light can follow it, and Home Assistant driving the station back.

More

• Produce a segment: a short programme the station writes and voices itself, a show of your own it makes episodes of, a listener's call, a guest in the studio, and the news on demand.
• Throw a party: a code on the TV, and guests asking for records from their phones with no account.