Files

T

ranger a22ddfb6d3 chore: initial commit — Radio v0.1.0 (Phase A complete)

First release of a-radio — a free, focused SomaFM player for the
WordPress admin. Extracted-and-rebuilt from RangerPlex's RadioPlayer
component, simplified along the way (no Node CORS proxy needed; the
browser plays SomaFM streams directly).

Phase A deliverables — all in this commit:

PLAYER SURFACES
- Dashboard widget on WP Admin → Dashboard (compact: play/pause +
  station select + volume).
- Dedicated admin page at WP Admin → Radio → My Radio (larger
  layout, station genre badge, volume %% display).
- Both surfaces share the same JS — picking a station on one mirrors
  to the other within the same admin session.

STATIONS
- 44 SomaFM stations grouped by 10 genres (Ambient / Electronic /
  Lounge / Rock / Metal / Jazz / World / Reggae / Holiday / Specials).
- Ported verbatim from RangerPlex's RadioPlayer.tsx.
- Default station: Groove Salad (most popular SomaFM channel, safe
  ambient/coding pick).

STATE
- Per-user state stored in user_meta under key `radio_state`:
  { station_id, volume, theme, last_played_at }.
- Settings page lets the user pick default station, default volume,
  theme (auto/light/dark), and hide the dashboard widget.
- AJAX endpoint `radio_save_state` persists changes without a page
  reload. Nonce-protected, capability-checked, only known keys
  accepted, station validated against the list, volume clamped to
  [0,1].

UPDATES
- Self-hosted updater wired to Gitea (ranger/a-radio) from commit 1.
- Direct port of Buddy's inc/updater.php with BUDDY_* → RADIO_* and
  buddy_* → radio_* renames. Same 12h-success / 1h-error caching.

ARCHITECTURE
- No `wp` prefix (trademark policy).
- GPL v2+ public Gitea repo from day one.
- Vanilla JS only — no React, no webpack, no minified-only files.
- CSS-only animations, all assets local.
- Single H1 per admin page.
- Direct HTML5 <audio> playback (SomaFM has CORS headers; no PHP
  audio proxy needed). This is the key simplification vs RangerPlex.

COMPLIANCE
- "Powered by SomaFM" credit displayed on both player surfaces with
  link to somafm.com. About page invites users to donate to SomaFM
  directly.

PHASE PROGRESSION (not in this commit)
- Phase B — Settings polish + retry on transient stream errors +
  README.md formatted for WP.org submission.
- Phase C — Now-playing metadata via SomaFM's per-station song
  history endpoint (this is where the RangerPlex proxy logic ports
  to — server-side, for metadata not audio).
- Phase D — [ranger_radio] shortcode for frontend embedding.
- Phase E — Favorites system.
- Phase F — Multi-provider (Radio Paradise / NTS / KEXP / BBC).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-26 09:40:23 +01:00

3.6 KiB

Raw Blame History

Changelog

All notable changes to Radio are documented here. Format: Keep a Changelog 1.1.0 — versioning: SemVer.

[Unreleased]

[0.1.0] — 2026-05-26

Radio is born. First release of a new standalone WordPress plugin extracted-and-rebuilt from the radio feature that lives inside RangerPlex. Radio stands on its own as a focused, friendly companion plugin for the WordPress dashboard — a tab of background music while you work.

Added — Phase A complete (player exists)

Dashboard widget at WP Admin → Dashboard showing a compact mini-player with play/pause, station select grouped by genre, and a volume slider.
Dedicated admin page at WP Admin → Radio → My Radio showing the same controls in a larger format with the station's genre badge and description.
44 SomaFM stations across 10 genres (Ambient, Electronic, Lounge, Rock, Metal, Jazz, World, Reggae, Holiday, Specials). Stream URLs use SomaFM's public 128kbps MP3 endpoints — no proxy server required.
Per-user state storage via user_meta (key: radio_state). Each WordPress admin remembers their own station choice, volume, and theme preference.
Settings page at WP Admin → Radio → Settings with default station, default volume, theme (auto/light/dark), and an opt-out for the dashboard widget. Updates panel shown to admins with manage_options.
About page at WP Admin → Radio → About with plain-language explanation of what the plugin does, who it's for, version history, and credits to SomaFM.
Self-hosted update checker wired up to the Gitea repo (ranger/a-radio) from commit 1. Polls /api/v1/repos/ranger/a-radio/releases/latest with a /tags?limit=1 fallback. 12h success cache, 1h negative cache.
AJAX endpoint radio_save_state for persisting station/volume changes without a page reload. Nonce-protected, capability-checked.
Custom admin-menu icon (dashicons-format-audio).
Direct HTML5 <audio> playback — no Node proxy, no PHP stream-passthrough, no server-side resource cost per listener. SomaFM's CORS headers make this work out of the box in modern browsers.

Architecture (locked from day one)

Single-word brand name Radio — no "WP" prefix, no marketplace trademark hurdle.
Public GPL v2+ Gitea repo at ranger/a-radio on git.davidtkeane.com.
Per-user state in user_meta under key radio_state.
Vanilla JS only — no React, no build step, no bundler. ~200 lines of JS controlling all interactions.
CSS-only animations, all assets local — bundle stays sub-100KB.
Single H1 per admin page, no nested toggle boxes — Tier-1 discipline carried forward from the Logbook + Buddy lineage.
Sanitize on input, escape on output throughout. Every AJAX endpoint nonce-protected and capability-checked.

Compliance

Station list and stream URLs are SomaFM's public, freely-published endpoints. Their terms allow redistribution with attribution.
"Powered by SomaFM" credit displayed in both player surfaces, linking to somafm.com.
The About page invites users to donate to SomaFM directly.

Not in this release (planned)

Phase B — Settings polish + README for WP.org submission + retry logic for transient stream errors.
Phase C — Now-playing metadata via SomaFM's per-station song-history endpoint.
Phase D — [ranger_radio] shortcode so the player can be embedded in posts/pages.
Phase E — Favorites system.
Phase F — Multi-provider (Radio Paradise, NTS Radio, KEXP, BBC) with a provider abstraction.

3.6 KiB Raw Blame History