> ## Documentation Index
> Fetch the complete documentation index at: https://docs.digcrate.app/llms.txt
> Use this file to discover all available pages before exploring further.

# /radio — Live radio

> Search and stream any of 30,000+ radio stations directly in the workspace

The `/radio` command searches the Radio Browser database of 30,000+ stations and starts streaming the best match in the Digcrate audio player. You can search by genre, station name, or pass a direct stream URL.

## Syntax

```
/radio [genre or station name]
```

```
/radio [https://stream-url]
```

| Parameter               | Description                                                       |
| ----------------------- | ----------------------------------------------------------------- |
| `genre or station name` | Any genre, vibe, or station name — the agent picks the best match |
| `https://...`           | A direct stream URL — starts playing immediately without a search |

## Examples

Search by genre:

```
/radio jazz
```

Search by station name:

```
/radio KEXP
```

Play a direct URL:

```
/radio https://kexp.streamguys1.com/kexp160.mp3
```

## How it works

<Steps>
  <Step title="Parse input">
    If the input starts with `http://` or `https://`, the agent skips the search and plays the stream directly using `play_radio`.
  </Step>

  <Step title="Search Radio Browser">
    For a genre or station name, the agent calls `search_radio` with the query. Genre queries search by tag; station name queries search by name.
  </Step>

  <Step title="Pick the best match">
    The agent selects the highest-voted station with a working stream. If multiple strong matches exist, it shows the top 3–5 and asks which one to play.
  </Step>

  <Step title="Start streaming">
    Calls `play_radio` with the station name or URL. The stream starts in the persistent audio player at the bottom of the workspace.
  </Step>
</Steps>

<Tip>
  The audio player persists across the workspace — you can keep a station playing while you research tracks, run show prep, or map influence chains.
</Tip>

## Related commands

<CardGroup cols={2}>
  <Card title="/prep" icon="radio" href="/commands/show-prep">
    Generate show prep for the station you're streaming
  </Card>

  <Card title="/news" icon="newspaper" href="/commands/news">
    Pull daily music news for a specific station's voice
  </Card>
</CardGroup>