# Radio — SomaFM player for your WordPress dashboard

A small, focused, free WordPress plugin that drops a SomaFM radio player into your admin dashboard. 44 hand-curated stations across 10 genres — ambient, electronic, lounge, rock, metal, jazz, world, reggae, holiday, and specials.

## What it does

- Mini-player on **WP Admin → Dashboard** (opt-out via Settings)
- Dedicated page at **WP Admin → Radio → My Radio**
- Plays via HTML5 `<audio>` — no proxy server, no third-party tracking
- Per-user state: each admin remembers their own station + volume
- Self-hosted update checker against the Gitea repo

## Installation

1. Download the latest release `.zip` from [git.davidtkeane.com/ranger/a-radio/releases](https://git.davidtkeane.com/ranger/a-radio/releases)
2. WP Admin → Plugins → Add New → Upload Plugin
3. Activate
4. Look at **WP Admin → Dashboard** for the mini-player, or **WP Admin → Radio**

## Requirements

- WordPress 5.0+
- PHP 7.4+
- A modern browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+)

## Credits

All stations and streams are provided by [SomaFM](https://somafm.com/), an independent, listener-supported, commercial-free internet radio network broadcasting from San Francisco since 2000. If you enjoy this plugin, please consider [donating to SomaFM directly](https://somafm.com/support/).

## License

GPL v2 or later. See `LICENSE` (the same GPL v2+ terms as WordPress itself).

## Author

David Keane — part of the RangerHQ plugin family. [rangersmyth.xyz](https://rangersmyth.xyz/)