---
title: "Radio Panel plugin for Grafana"
description: "Interactive vinyl-style radio panel for Grafana with day-based station scheduling and optional timed… Radio Panel plugin for Grafana by teuwsenservices."
---

> This is the Markdown version of https://grafana.com/grafana/plugins/teuwsenservices-radio-panel/

# Radio Panel

- Developer: teuwsenservices
- Version: 1.4.0
- [Installation](https://grafana.com/grafana/plugins/teuwsenservices-radio-panel/installation.md)
- [Change log](https://grafana.com/grafana/plugins/teuwsenservices-radio-panel/changelog.md)

![Radio panel compact view](https://grafana.com/api/plugins/teuwsenservices-radio-panel/versions/1.4.0/images/img/screenshot-1.png)

![Radio panel full dashboard view](https://grafana.com/api/plugins/teuwsenservices-radio-panel/versions/1.4.0/images/img/screenshot-2.png)

Interactive vinyl-style radio panel for Grafana. The panel supports weekday-based station scheduling, optional timed override, and now playing metadata per station.

## Screenshots

![Compact panel view](https://raw.githubusercontent.com/finnie2006/teuwsenservices-lpradio-panel/main/src/img/screenshot-1.png) ![Dashboard view](https://raw.githubusercontent.com/finnie2006/teuwsenservices-lpradio-panel/main/src/img/screenshot-2.png)

## Features

- Clickable vinyl disk UI that plays a configured radio stream.
- Day-by-day station setup or one shared station for all days.
- Optional station presets with per-day preset selection.
- Timed override for selected weekdays between a start and end hour.
- Now playing presets for NPO Sterren NL, Arrow Classic Rock, and custom JSON APIs.
- Optional continuous playback mode for dashboard playlist transitions.
- Styling controls for panel, disk, and label borders.
- Grafana variable support in station name, stream URL, and logo URL.

## Station presets

You can optionally use presets as a faster way to configure day schedules.

1. Enable `Use station presets for days` in panel options.
2. Configure preset slots in the `Presets` category.
3. Select a preset per day in the `Stations` category.
4. Choose `No preset` for a day to use that day's custom station fields.

This is additive and non-breaking: existing day-by-day station setup continues to work.

## Dashboard playlists

The radio only has to be on one dashboard of a playlist. With `Continue playback in playlists` enabled it keeps playing on dashboards without a radio panel.

1. Put the radio panel on the first dashboard of the playlist. Grafana reloads the page after every third playlist loop, and playback resumes as soon as a radio panel is loaded again.
2. Click the disc once. Browsers block audio until a visitor interacts with the page, and may block the resume after a reload too. In that case the panel shows the `Start hint text`. On an unattended screen, start Chrome with `--autoplay-policy=no-user-gesture-required`.
3. While the radio plays on a dashboard without a radio panel, a small stop button is shown. Disable `Show stop button without panel` to hide it on unattended screens.

Stream recovery keeps working on dashboards without a radio panel. The station schedule is only applied while a radio panel is on screen.

## Now Playing and CORS

This panel runs in the browser as a Grafana panel plugin and cannot use Grafana's server-side data source proxy for arbitrary HTTP requests. Some external now-playing APIs block browser-origin requests due to CORS policy.

The Arrow Classic Rock preset uses `r.jina.ai` as a default CORS-friendly wrapper so metadata can be fetched in browser context.

You can set one global CORS proxy for all stations with the panel option `Now playing CORS proxy URL`.

- Leave empty to use the preset default behavior.
- Use a URL prefix (for example `https://r.jina.ai/`) to prepend the API URL.
- Or use `{{url}}` placeholder when your proxy expects a query parameter (for example `https://my-proxy.example/fetch?url={{url}}`).

When a now-playing request is blocked by CORS (or another network-level browser restriction), the panel stops polling that endpoint for the active station and falls back to the normal station/status text. When a configured API responds successfully but has no current track, the panel shows a dedicated placeholder such as `No track available` instead of the old station status text.

By default metadata is only fetched while the panel is playing. Disable `Only fetch now playing while playing` to also show it on a stopped panel.

## Add your own now-playing API

Yes. You can configure your own endpoint without code changes:

1. Set the station `now playing preset` to `Custom JSON API`.
2. Fill in `now playing API URL` with your endpoint.
3. Optionally set `Now playing CORS proxy URL` when the endpoint blocks browser CORS.
4. If the API is valid but no track is currently returned, the panel shows the `No track available text` option from the Display settings.

The custom parser tries common keys such as `artist`, `title`, `song`, `track`, `image`, and `coverUrl`, as well as common nested structures like `tracks[0]`, `currentTrack`, `latestTrack`, and `data.items`.

### Example: custom now-playing API

```text
https://example.com/api/nowplaying?station=main
```

Example payload shape:

```json
{
  "station": "main",
  "tracks": [
    {
      "artist": "Mau P",
      "title": "Neck",
      "albumArt": "https://cdn.example.com/covers/abc123.jpg"
    }
  ]
}
```

The parser also supports other common shapes such as `currentTrack`, `latestTrack`, `data.items`, `artist` + `title` at the root, and `coverUrl` / `image` / `artwork` values.

## Requirements

- Grafana `>=12.3.0`

## Support

- Repository: <https://github.com/finnie2006/teuwsenservices-lpradio-panel>
- Issues: <https://github.com/finnie2006/teuwsenservices-lpradio-panel/issues>
