Radio Player Page

Beschrijving

Radio Player Page creates dedicated, independent pages for your radio streams, providing continuous playback without interruptions. The plugin serves a clean, standalone HTML page with an embedded React application, ensuring complete theme independence and optimal performance.

Belangrijkste functies

  • Streaming Protocol Support – Automatic detection and handling for Icecast, Shoutcast, MP3, HLS (.m3u8), and DASH (.mpd) formats. Uses native browser support on iOS Safari for HLS streams
  • Four Audio Visualizers – Choose from Oscilloscope, Bars Spectrum, Amplitude Waterfall, or Spectral Particles for real-time audio visualization powered by Web Audio API
  • Eight Color Themes – Customize appearance with Neutral, Blue, Green, Red, Orange, Yellow, Purple, or Pink color schemes
  • Custom Branding – Upload custom background images and logos for each station (site favicon used if no custom logo provided)
  • Custom Station Titles – Set a unique title for each stream, or use your site name as default
  • Sleep Timer – Automatic playback stop after 30 minutes, 1 hour, or 2 hours
  • Multiple Stream Management – Configure up to 10 independent streams, each with its own dedicated WordPress page
  • Volumeregeling – Aanpasbare volumeknop slider (niet beschikbaar op iOS apparaten vanwege systeembeperkingen)
  • Media Session API – Toont zenderinformatie en illustraties op het vergrendelscherm van het apparaat en mediabesturingselementen
  • Responsive Design – Optimized for desktop, tablet, and mobile devices
  • Performance Optimized – Lightweight architecture with minimal HTTP requests

Technische details

The player interface is built with React 19, TypeScript, and Material-UI, providing a modern, accessible user experience. The plugin uses Vite for asset bundling and includes proper cache busting through manifest-based asset loading.

Schermafbeeldingen

  • Player page example with blue theme color and Oscilloscope visualizer
  • Player page example with yellow theme color and Amplitude Waterfall visualizer
  • Player page example with green theme color and Bars Spectrum visualizer
  • Beheer instellingen voor stations beheren

Installatie

  1. Upload the radio-player-page folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress Plugins screen directly.
  2. Activeer de plugin via het ‘Plugins’ scherm in WordPress.
  3. Navigate to Settings Radio Player Page Settings.
  4. For each stream:
    • Enter your streaming URL (Icecast, Shoutcast, HLS, DASH, or MP3)
    • Select the WordPress page where the player should appear
    • Optionally customize: title, theme color, visualizer type, background image, and logo
  5. Klik Wijzigingen opslaan en bezoek de toegewezen pagina

Important Notes

  • Elke station vereist zowel een geldige stream-URL als een toegewezen WordPress pagina

FAQ

Will the player conflict with my theme?

No. Player pages are completely independent of your WordPress theme, served as standalone HTML pages without loading theme styles or scripts.

Moet ik iets configureren op de WordPress pagina?

No. Once you assign a page to a stream in the plugin settings, no additional configuration is needed on the page itself. The plugin intercepts page requests using WordPress template redirect hooks and serves a standalone HTML page with the player. The page content, template, and any existing settings are bypassed, ensuring the player displays correctly without any page-level configuration.

Where can I get support or report issues?

Visit the WordPress Support Forum for help, feature requests, and to report any bugs.

What is the sleep timer feature?

The sleep timer allows you to automatically stop playback after a set duration. Available options are 30 minutes, 1 hour, or 2 hours. The timer only runs while playback is active and can be cancelled at any time.

Kan ik dit gebruiken voor commerciële radiostations?

Yes. The plugin is free and open-source, suitable for both commercial and non-commercial radio stations.

Why is the volume control not available on my iOS device?

Volume control is not available on iOS devices due to system limitations. iOS devices use the system volume controls instead.

Where can I view the full source code?

The source code is hosted on GitHub. See the repository for contributions and issue tracking.

Beoordelingen

16 september 2025
This plugin gave me a dedicated player for my shoutcast stream under 5 mins. No fluff at all. Just paste the link, pick a page, and you’re good to go
13 september 2025
The setup is super straightforward and easy to understand. I like that it keeps things simple without adding a bunch of unnecessary settings.
10 september 2025 2 reacties
works great for keeping the radio player running without stopping when clicking around the site could you add an option to upload an image or logo to display with the player? regards
Lees alle 3 beoordelingen

Bijdragers & ontwikkelaars

“Radio Player Page” is open source software. De volgende personen hebben bijgedragen aan deze plugin.

Bijdragers

“Radio Player Page” is vertaald in 7 localen. Dank voor de vertalers voor hun bijdragen.

Vertaal “Radio Player Page” in je eigen taal.

Interesse in ontwikkeling?

Bekijk de code, haal de SVN repository op, of abonneer je op het ontwikkellog via RSS.

Changelog

2.0.2

  • Added player interface translations for Swedish, Dutch, Mexican Spanish, and Romanian
  • Fixed the logic determining when to use translation files
  • Ensured code compatibility starting from PHP 5.6

2.0.1

  • Added player customization options – per-station configuration background images and logos
  • Added theme color selection – choose from eight color themes (Neutral, Blue, Green, Red, Orange, Yellow, Purple, Pink) for each stream
  • Added visualizer selection – choose from four audio visualizers (Oscilloscope, Bars Spectrum, Amplitude Waterfall, Spectral Particles) for each stream
  • Added Media Session API integration – displays station information and artwork on device lock screens and media controls

1.2.1

  • Added support for HLS (.m3u8) and DASH (.mpd) streaming using hls.js and dash.js
  • Improved streaming protocol detection and handling

1.2.0

  • Added support for multiple streams (up to 10)
  • Added optional custom stream title field
  • Improved Settings screen with dynamic streaming management interface
  • Toegevoegd achterwaartse compatibiliteit migratie van single-stream versie
  • Verbeterde gebruikerservaring met betere formuliercontrole en pagina selectie