Skip to main content

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. Invent a kind of break: a brief for something new the presenter says, such as a poem at a quarter to the hour, put on the clock and shared with another station as a file.
  5. Two recurring shows: a Friday chart countdown and a nightly metal show, set up once and aired every week.
  6. A holiday special: a Halloween night that takes over from the weekly schedule for its hours and comes back every year.
  7. A show for a festival: a festival's dates and bill, and a special that plays the acts on it and talks about it until it is over.
  8. Give a show its own sound: its own jingles and idents, and a music bed under every break its host speaks.
  9. Make the news start on the dot: a band that waits for its time behind a bed when the records run early, and fades a record out when they run late.
  10. Make a voice: design one in Claude with ElevenLabs, clone it, and give it to a character.
  11. Teach the presenter to say a name: a name the station says wrongly, fixed and heard before it airs.

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.
  • Keep records off the air: a dislike for one record or artist, a never-play rule for a whole genre or live recordings, and keeping the station clean.
  • News and weather in the breaks: headlines from your own feeds, a forecast for where the station is, a bulletin at the top of the hour, the date and a piece of trivia between records, breaking news as it happens, and a longer news programme made fresh each evening.
  • Carry a podcast: subscribe to a show and give its newest episode a time on the clock.
  • Read a book on air: a chapter every night, read in the station's own voice from an EPUB, picking up where it left off.
  • Play the station on a speaker: a Chromecast, a Sonos, a BluOS player or a UPnP renderer, started from the Desk.
  • Let friends listen: the station reachable from outside the house, a friend invited as a listener, and the phone app with requests and the words of each record.
  • 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.
  • Do a live show: an encoder on your own computer, a show booked on the timetable, a countdown onto the air, and the recording to listen back to.
  • Throw a party: a code on the TV, and guests asking for records from their phones with no account.
  • Run it from a Stream Deck: what is on air, Skip, Stop and your opinion of the record, under your fingers.

On your phone​