rangerhq-radio/README.md

# 📻 RangerHQ Radio — SomaFM player for your WordPress dashboard

[![wp.org version](https://img.shields.io/wordpress/plugin/v/rangerhq-radio.svg?style=flat-square&color=6dbf7a&label=wp.org&logo=wordpress&logoColor=white)](https://wordpress.org/plugins/rangerhq-radio/)
[![downloads](https://img.shields.io/wordpress/plugin/dt/rangerhq-radio.svg?style=flat-square&color=2a7d3e&logo=wordpress&logoColor=white)](https://wordpress.org/plugins/rangerhq-radio/)
[![rating](https://img.shields.io/wordpress/plugin/rating/rangerhq-radio.svg?style=flat-square&color=6dbf7a)](https://wordpress.org/plugins/rangerhq-radio/)
[![tested up to](https://img.shields.io/wordpress/plugin/tested/rangerhq-radio.svg?style=flat-square&label=tested%20up%20to&color=2a7d3e)](https://wordpress.org/plugins/rangerhq-radio/)
[![PHP](https://img.shields.io/wordpress/plugin/required-php/rangerhq-radio.svg?style=flat-square&logo=php&logoColor=white&color=777BB4)](readme.txt)
[![license](https://img.shields.io/badge/license-GPL%20v2%2B-2a7d3e?style=flat-square)](LICENSE)
[![last commit](https://img.shields.io/gitea/last-commit/ranger/rangerhq-radio?gitea_url=https%3A%2F%2Fgit.davidtkeane.com&style=flat-square&color=6dbf7a)](https://git.davidtkeane.com/ranger/rangerhq-radio/commits/branch/main)
[![SomaFM stations](https://img.shields.io/badge/SomaFM%20stations-44-6dbf7a?style=flat-square)](https://git.davidtkeane.com/ranger/rangerhq-radio/wiki/Stations)
[![no telemetry](https://img.shields.io/badge/telemetry-none-6dbf7a?style=flat-square)](https://git.davidtkeane.com/ranger/rangerhq-radio/wiki/Privacy)
[![made in Dublin](https://img.shields.io/badge/made%20in-Dublin%2C%20Ireland-2a7d3e?style=flat-square)](https://davidtkeane.com)

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
- Updates via WordPress.org (the canonical channel once published)

## Installation

1. Download the latest release `.zip` from [git.davidtkeane.com/ranger/rangerhq-radio/releases](https://git.davidtkeane.com/ranger/rangerhq-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/)