Radio Player Page

Description

Radio Player Page provides dedicated, standalone player pages for your radio broadcasts on WordPress. It lets you create a full weekly radio schedule, manage your broadcasts, and present everything on pages that guarantee reliable, theme-independent listening.

The Power of Player Pages

  • Independent Player Pages – Each station lives on its own independent HTML page, completely bypassing your WordPress theme. This ensures zero theme conflicts, optimal performance, and one clear URL per radio station.
  • Full Radio Scheduling – Create a weekly lineup with named radio shows and optional logos. The player intelligently displays the current and next radio show, with timezone-aware calculations and overlap prevention.
  • Universal Stream Compatibility – Works seamlessly with Icecast, Shoutcast, HLS (.m3u8), DASH (.mpd), and MP3 streams. Automatic protocol detection with native iOS Safari support for HLS.

Broadcast Management

  • Multi-Station Control – Manage multiple independent stations from a single WordPress installation, each with its own stream, schedule, and branding.
  • Emission Timezone Clock – Keep a global audience informed. When your station’s timezone differs from the listener’s, a discreet clock shows the station’s local time and the offset.
  • Media Session API – Professional integration with device lock screens and media controls, displaying station art and info.
  • Radio Schedule Block – Add a Block to any post or page to display the full weekly radio schedule for a selected station. Design is controlled by the editor and theme (Block Supports, theme.json).
  • Radio Shows List Block – Add a Block to list all radio shows for a selected station, with optional image, extended description, and broadcast schedule.

Listener Experience

  • Informed Listening – The player clearly shows what’s on air now and what’s coming next.
  • Visual Customization – Choose from 8 color themes and 4 real-time audio visualizers (powered by Web Audio API) to match your station’s brand.
  • Station Branding – Upload custom background images and logos for each radio station.
  • Convenience Features – Sleep timer, responsive design, and social sharing meta tags for rich link previews.

Built for Modern Web Performance
The player is a self-contained application built with React 19, TypeScript, and Vite, ensuring a fast, accessible, and maintainable experience. It uses manifest-based asset loading for seamless updates.

Screenshots

  • Player page with blue theme and Oscilloscope visualizer.
  • Player page with yellow theme, Bars Spectrum visualizer, and timezone clock.
  • Player page with green theme, Amplitude Waterfall visualizer, and sleep mode active.
  • Player page with pink theme and Schedule modal open.
  • Player page with orange theme and All Radio Shows modal open.
  • Edit Radio Station screen.
  • Edit Radio Show screen.
  • Edit Radio Schedule screen.

Installation

  1. Upload the radio-player-page folder to the /wp-content/plugins/ directory, or install the plugin through the WordPress Plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress.
  3. Go to RPP Radio Stations in the admin menu. Click Add New to create a station.
  4. For each station:
    • 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. Publish or update the station and visit the assigned page. Optionally use RPP Radio Shows to create radio shows and build the weekly schedule on each station.

Important Notes

  • Each radio station requires both a valid streaming URL and an assigned WordPress page.

FAQ

Do I need to configure anything on the WordPress page?

No. Once you assign a page to a station on the RPP Stations edit screen, 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’s normal front-end output (content, template, blocks) is bypassed for that URL, so the player always loads reliably without page-level setup.

Where can I get support or report issues?

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

Can I use this for commercial radio stations?

Yes. The plugin is free and open-source (GPLv2 or later), suitable for both commercial and non-commercial radio stations.

Where can I view the full source code?

The source code is hosted on GitHub.

Reviews

September 16, 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
September 13, 2025
The setup is super straightforward and easy to understand. I like that it keeps things simple without adding a bunch of unnecessary settings.
September 10, 2025 2 replies
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
Read all 3 reviews

Contributors & Developers

“Radio Player Page” is open source software. The following people have contributed to this plugin.

Contributors

“Radio Player Page” has been translated into 11 locales. Thank you to the translators for their contributions.

Translate “Radio Player Page” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

3.3.0

  • Added Radio Schedule block.
  • Added Radio Shows List block.
  • Radio stations and radio shows now use CPTs.