TuneSera – Internet Radio Player & Station Directory

By WPSera

0+ active installationsVersion 0.2.0

Create an online radio directory with a live radio player, station pages, country and genre browsing, and easy station imports.

Description

TuneSera turns your WordPress site into an online radio directory with a live radio player. List internet radio stations from around the world, let visitors search and filter by country, genre and language, and keep the music playing in a sticky player while they browse.

It plays Icecast, SHOUTcast, Zeno and other web radio streams, shows the song that’s playing when the stream provides it, and gives every radio station its own SEO-friendly page. A setup wizard creates your directory in minutes: import the bundled stations, upload your own CSV or add stations by hand.

See a live demo → WorldRadio.online

Want to see it in action first? WorldRadio.online is a real radio directory built with TuneSera. Search stations, browse by country and genre, open a station page and keep listening in the sticky player as you move around the site.

New in 0.2.0

  • Page builder compatibility: Every display component is now a block for the block editor, an Elementor widget and a Divi module, with the same settings as its shortcode.
  • Installable app (PWA, Pro): Listeners can install your directory on their phone or desktop, with its own icon, splash screen and offline shell.
  • Auto HTTP popup (Pro): Stations that only stream over HTTP open automatically in a popup player on HTTPS sites, instead of being blocked by the browser.

Perfect for

  • Online radio directories and radio station listing sites
  • Country, city or regional radio portals, such as every FM and web radio station in your country
  • News, talk, sports, music or religious radio sites
  • Diaspora and language-based radio websites
  • Broadcasters and radio networks that want to show their stations with a live stream player
  • Music blogs and community sites that want an internet radio player

Free Features

  • Bundled stations: 1,186 ready-to-import stations from 30 countries, included with the plugin.
  • Radio directory: Search, country and genre filters, sorting, pagination, and list or grid layouts. Visitors’ last filters and view are remembered.
  • Browse pages: Browse stations by country, genre or language with search, A–Z filters and station counts.
  • Station pages: A page for every station with its logo, details, contact and social links, plus location archives and RadioStation structured data.
  • Live player: A sticky player that keeps playing while visitors browse, with now-playing info for Icecast, SHOUTcast, ICY and Zeno streams when available.
  • Lock-screen controls: Station name, song title and artwork on the phone lock screen and notification shade, with play, pause, previous and next station controls (Media Session API).
  • Sharing: Share stations by link, email, device share sheet, WhatsApp, Facebook or X. Each option can be turned off.
  • Station imports: Import the bundled directory or a CSV file, review before importing, avoid duplicates, and run imports in the background.
  • Import history: Track progress, view per-country results, download reports and export history as CSV.
  • Easy management: Setup wizard, dashboard, modern Stations and Genres screens with quick edit, bulk actions and duplicate genre merging (classic screens one click away), a station editor with a stream tester and a location explorer.
  • Design: Colour presets, a custom accent colour and a live preview on desktop, tablet and mobile.
  • Shortcodes: [tunesera_directory], [tunesera_stations], [tunesera_station], [tunesera_search], [tunesera_browse_countries], [tunesera_genres] and [tunesera_browse_languages], with a built-in shortcode builder.
  • Page builders: Every shortcode is also a block for the block editor, an Elementor widget and a Divi module, with the same settings.
  • Settings tools: Export, import and reset settings, with optional data cleanup on uninstall.

Pro Features

TuneSera Pro is a separate paid add-on. Every free feature works without it. Pro adds:

  • Global catalog: 70,000+ stations across 230 countries.
  • Media Library logos: Save imported station logos to your Media Library.
  • CSV field mapping: Import CSV files with any column names.
  • Featured and popular stations: Curated and most-played sections with shortcodes.
  • Local discovery: Open the directory on stations from the visitor’s country.
  • Listening analytics: Plays, listeners, listening time and top stations, stored on your own site.
  • Advanced player: Extra player styles, popup player, sleep timer, default station and track artwork.
  • Auto HTTP popup: Stations that only stream over HTTP open automatically in a popup window that can play them, instead of being blocked by the browser.
  • More design controls: Typography, spacing, buttons, page layouts and the [tunesera_player] and [tunesera_locations] shortcodes, also available as blocks, Elementor widgets and Divi modules.
  • Installable app (PWA): Let listeners install your directory on their phone or desktop with its own icon, splash screen and standalone window. Install button and banner, iPhone instructions, an offline shell and an offline page, all configured under Settings > App.

Get Pro – Upgrade Now →

Links

Follow WPSera

External services and privacy

TuneSera needs no account and sends no data to WPSera. Bundled stations, location data and assets ship with the plugin.

  • Station streams and logos: When a station plays or its logo is shown, the visitor’s browser connects to that station’s host, which receives the visitor’s IP address and browser headers. Each host has its own terms.
  • WorldRadio.Online: Bundled station logos load from worldradio.online. You can replace them with your own images. Terms · Privacy
  • Now-playing metadata: When enabled (the default), your server requests track info from the station’s stream host, sending the stream path, plugin version and site URL. Visitor IPs are not sent. Turn it off under Settings > Metadata.
  • Zeno: For Zeno stations, your server requests metadata from api.zeno.fm when metadata is enabled. Terms · Privacy
  • Sharing: WhatsApp, Facebook and X are contacted only when a visitor clicks a share link, receiving the station URL and title. WhatsApp · Facebook · X
  • YouTube: The TuneSera dashboard embeds the intro video from youtube-nocookie.com only after an administrator clicks “Watch the quick tour”. Nothing loads from YouTube before that, and visitors are never affected. Terms · Privacy
  • Storage: Uploaded CSV files are kept privately for up to 30 days. The directory stores preferences in local storage and a 30-day first-party cookie (tunesera_listing_initial), never for tracking.

Credits

Country flags by flag-icons (MIT license, see assets/vendor/flags/LICENSE).

Source code

Readable source for the compiled files in build/ is included in assets/src/. PHP source is in includes/ and templates/.

Installation

  1. Go to Plugins > Add New Plugin, search for “TuneSera”, then install and activate it. You can also upload the ZIP under Plugins > Add New Plugin > Upload Plugin.
  2. Open TuneSera > Setup Wizard and follow the steps.
  3. Visit your directory page, or add [tunesera_directory] to any page.

FAQ

How do I show the directory?

Pick a page in the setup wizard, or add [tunesera_directory] to any page.

Where do the stations come from?

Import the bundled directory (1,186 stations, 30 countries), upload a CSV file, or add stations by hand. The bundled directory ships with the plugin, so importing it calls no outside API.

Can I import my own CSV file?

Yes. Download the sample CSV from TuneSera > Import Stations and use its column names. Station name, stream URL and country code are required.

Will re-importing create duplicates?

No. Stations are matched by source ID. Existing stations are kept unless you choose to update them.

Does it play Icecast and SHOUTcast streams?

Yes. TuneSera plays any stream URL the visitor’s browser supports, including MP3 and AAC streams from Icecast, SHOUTcast, Zeno and other hosts. Song titles appear when the stream sends now-playing metadata.

Can I use it for a single radio station?

Yes. Add your station and show it anywhere with [tunesera_station id="123"]. The sticky player keeps your stream playing as listeners move between pages.

Does it work with Elementor, Divi and the block editor?

Yes. Every shortcode is also a block, an Elementor widget and a Divi module with the same settings.

Is it good for SEO?

Each station gets its own page with RadioStation structured data, and countries, cities and genres get their own archive pages. You can also change the URL slugs under Settings.

Why won’t a station play?

The stream may be offline, use a format the browser can’t play, or block outside access. HTTPS sites block HTTP-only streams; TuneSera Pro can open those stations in a popup window that plays them (Settings > Player > Open HTTP streams in a popup). Use the stream tester in the station editor to check a stream.

Why is there no song title?

Song titles only appear when the station’s stream sends metadata. You can turn metadata off under TuneSera > Settings > Metadata.

Do I need TuneSera Pro?

No. All features in the main list work without Pro.

Can visitors install my directory as an app?

Lock-screen playback controls work in the free plugin. Installing the directory as an app on a phone or desktop (a web app manifest, install prompts and an offline shell) is part of TuneSera Pro, under Settings > App, and requires an HTTPS site.

Does deleting the plugin remove my stations?

Only if you turn on the uninstall cleanup option under TuneSera > Settings > Advanced first. Deactivating never removes data.

Screenshots

Changelog

0.2.0

  • New: Page builder compatibility. Blocks, Elementor widgets and Divi modules for every display component.
  • New: Installable app (PWA) with install prompts and an offline shell (Pro).
  • New: Auto HTTP popup plays HTTP-only streams on HTTPS sites (Pro).
  • New: Modern Stations and Genres screens with quick edit, bulk actions and genre merging, plus a Classic switch.
  • Improved: Redesigned Import Stations, Locations, Dashboard and Setup wizard.
  • Fixed: Renaming and moving divisions and cities in Locations.
  • Fixed: Empty directory filters when local discovery is on, and sleep timer text contrast (Pro).

0.1.0

  • Initial release.
  • Lock-screen and notification playback controls with station name, song title and artwork (Media Session API).