WorldRadios - Radio Directory WordPress Theme

WorldRadios: a complete live radio website for WordPress

WorldRadios turns WordPress into a live FM and online radio directory: a fast, beautiful theme with a player that keeps playing while visitors browse, and a plugin that holds the stations, Now Playing song titles, a Radio-Browser importer, AdSense and SEO tools, a member area and the API for an Android and iPhone app. A guided setup wizard imports 1,827 stations in one click.

Live demo — tap an image

A home page that hooks listeners

Hero with search and live numbers, featured and trending rows, country flags and browse tiles. Everything is driven by your stations.

Station pages with Now Playing

A big player card, the song on air right now with artist and cover art, share buttons, an embed player and related stations. The player bar keeps playing while visitors move around the site, with volume, favourites and a sleep timer.

Browse by country, language and genre

Country, language, genre, category and tag pages, instant filters and search across all stations. Phone-first design with a mobile menu.

Install in two minutes

Upload the plugin and the theme, then follow four steps: server check, brand and colour, starter content, finish. The demo directory imports itself in small steps, so it works on shared hosting.

A dashboard for the whole directory

Counts, top stations, listener reports and quick links, with Import, Now Playing, Mobile App, VIP, Submissions, Members and Settings one click away in the WordPress menu.

Your brand colours in one click

Eight colour themes (the default is Tamil Gold) or your own colours, light or dark mode, logo, favicon and default station logo from the media library. Visitors can pick their own colour and mode.

Let station owners submit and manage

A public submit form with logo upload, an owner area, approve and reject with e-mail notices, a contact form, spam protection and a branded e-mail layout.

Now Playing straight from the stream

Reads song titles from ICY, Icecast, Shoutcast and HLS streams, finds cover art, keeps a short history and lets you test any stream from the admin.

Ads, SEO and sitemap built in

Seven AdSense slots with ads.txt, a paged XML sitemap that copes with thousands of stations, robots.txt, Open Graph, Twitter cards and JSON-LD.

Mobile app (Flutter source included) and VIP billing

The package includes the Flutter source of the Android and iPhone app with its own illustrated guide. The app reads everything from your WordPress site: stations, colours, languages, ads and VIP plans. Sell VIP subscriptions through Google Play and the App Store; purchases are verified with the store and webhooks are signed and checked.

Prefer a standalone PHP application?

WorldRadios is also available as a Laravel (PHP) edition on Codester: the same design, the same radio directory and the same features, with its own admin panel, for servers where you control the PHP environment. Choose the WordPress edition if you want to run it as a theme and plugin on a WordPress site. See the Laravel edition.

What you get

• The WorldRadios theme and the WorldRadios Core plugin as two installable zips
• 1,827 starter stations with countries, languages, genres and tags
• The Flutter app source (Android and iPhone) with a separate illustrated guide for building and publishing it
• Elementor widgets and translation templates (POT files)
• Illustrated documentation and a quick-start note

Requirements at a glance

• WordPress 5.8 or newer, PHP 7.4 to 8.4, MySQL 5.7+ or MariaDB 10.3+
• No Composer, Node.js or SSH needed

Support and updates

Support through the Codester item page covers installation, configuration and bugs in the item. Server administration and custom development are not included.

Features

Player and stations

• Persistent player bar with volume, favourites, recently played and a sleep timer (5 to 120 minutes)
• HLS (.m3u8), .pls and .m3u streams, plus a stream relay so http streams play on https sites
• 1,827 starter stations with 86 countries, 70 languages, genres, categories and 1,230 tags
• Station pages with share buttons, embed code, report-a-problem form and related stations
• Search, instant filters, country, language, genre, category and tag pages

Now Playing

• Song title, artist and cover art from ICY, Icecast, Shoutcast and HLS streams
• Song history, per-station switch, custom metadata address and fixed title
• Test any stream from the admin; answers are cached so many listeners do not hammer a stream

Content tools

• Radio-Browser importer with batches, filters and an automatic daily, weekly or monthly schedule
• Stream-link checks that never overwrite hand-edited links
• Logo finder (favicon, website and social images) with bulk action and media-library storage

Community

• Public submit form with logo upload, spam trap and rate limits
• Moderation: approve, edit or reject with an e-mail note
• Member area for station owners; edits arrive as requests
• Contact form, messages list, branded HTML e-mails with an e-mail log

Design

• Fully responsive, phone-first layouts
• 8 colour themes plus custom colours, light and dark mode, visitor colour picker
• Elementor widgets (hero, stations, countries and genres, tiles, search), full-width page template, block editor friendly

Money and search

• Google AdSense with 7 slots, ads.txt, optional label, hidden for members if you wish
• Paged XML sitemap, robots.txt, canonical links, Open Graph, Twitter cards, JSON-LD
• Per-station SEO box with auto-fill, Google verification and head code field

Mobile app

• App API for the Android and iPhone app: stations, search, favourites, Now Playing, languages
• VIP products and purchases for Google Play and the App Store with verified purchases, signed webhooks and hourly re-checks

Setup and developers

• Setup wizard with server check, brand step and one-click demo import
• Translation ready with POT files, hooks and filters for every part, automated tests for the plugin modules

Requirements

• WordPress 5.8 or newer (a normal WordPress hosting plan is enough)
• PHP 7.4 to 8.4 with curl, json, mbstring, openssl and gd or imagick
• MySQL 5.7+ or MariaDB 10.3+
• Pretty permalinks (the wizard switches them on)
• No Composer, Node.js or SSH needed
• Optional: an SMTP plugin for e-mail, an AdSense account, Google Play and App Store accounts for VIP billing, Elementor for the widgets

Instructions

Install

1. Upload the package and unzip it. It contains worldradios-core.zip (plugin) and worldradios-theme.zip (theme).
2. In WordPress open Plugins, Add New, Upload Plugin, install worldradios-core.zip and activate it.
3. Open Appearance, Themes, Add New, Upload Theme and install worldradios-theme.zip.
4. The setup wizard opens: check the server, name your site and pick a colour, import the demo directory (tick "Activate the WorldRadios theme"), finish.
5. Set a real cron job (see the documentation) and install an SMTP plugin for e-mails.

Updates

1. Upload the new plugin and theme zips with "Replace current with uploaded". Your stations and settings are kept.

The illustrated step-by-step guide is in documentation/index.html.