Analogix Pro - Radio Player & Tuner

1. Introduction

Thank you for purchasing Analogix Pro - Radio Player & Tuner. This plugin turns any WordPress site into a live internet radio experience with a realistic analog dial interface. Your visitors sweep through frequencies with authentic tuning sound effects, lock onto FM/AM stations, and keep listening as they browse your site.

Key features

Analog dial tuner — frequency scale with a moving needle, tuning sweep sound effects, and FM/AM band switching.
Graphic equalizer — an 8-band Web Audio API equalizer with a live "EQ on/off" indicator.
VU meter themes — animated analog VU dials rendered in crisp SVG.
Station directory search — search tens of thousands of stations via the free Radio-Browser directory, plus an optional premium RapidAPI source.
Persistent footer player — seamless page transitions (PJAX) keep the audio playing without interruption.
Six themes & deep customization — Light, Dark, VU Light/Dark, and FM-AM Light/Dark, each with configurable accent color, background, opacity, blur and digit typography.
Privacy friendly — all fonts and icons are bundled locally; no third-party CDN calls, GDPR-friendly out of the box.

2. Requirements

Item	Minimum	Recommended
WordPress	5.9	Latest stable
PHP	7.4	8.1 or newer
Browser	Any modern browser with Web Audio API support	Latest Chrome / Firefox / Safari / Edge
Site protocol	HTTP or HTTPS	HTTPS (see Troubleshooting about stream mixed-content)

No external account requiredThe plugin works fully out of the box using its bundled stations and the free Radio-Browser directory. A RapidAPI key is only needed if you want the optional premium search source.

3. Installation

Option A — Upload through WordPress (recommended)

Download analogix-pro.zip using the download link in your purchase confirmation email.
In your dashboard go to Plugins → Add New → Upload Plugin.
Choose analogix-pro.zip and click Install Now.
Click Activate.

Option B — Manual FTP install

Unzip analogix-pro.zip on your computer.
Upload the resulting analogix-pro folder to /wp-content/plugins/.
Go to Plugins in your dashboard and activate Analogix Pro - Radio Player & Tuner.

After activationA new Radio Tuner item appears in the admin menu, and a small set of demo FM/AM stations is created automatically so you can test immediately.

4. Displaying the Player

There are two ways to show the tuner on the front end. You can use either or both.

A. Persistent footer player

Go to Radio Tuner → General Settings and enable Enable Frontend Tuner Player. The tuner then floats at the bottom of every page across your site and survives page navigation.

B. Shortcode (inline player)

To place the tuner inside a specific page, post, or widget area, use the shortcode:

[radio_tuner_player]

Paste it into the WordPress editor (a Shortcode block works well) wherever you want the inline player to appear.

TipThe footer player and the shortcode share the same station list and design settings, so anything you configure applies to both.

5. Managing Stations

Open Radio Tuner → Manage Stations. If the active design is one of the FM-AM themes, you will see an FM / AM band switch; other themes manage the FM list only.

Adding a station

Fill in the form on the right side of the Stations tab.
Click Add Station. Stations are automatically sorted by frequency.

Station fields

Field	Description
Station Name required	Display name shown in the player.
Frequency required	FM: 88.0–108.0 MHz (one decimal). AM: 530–1700 kHz (integer). Each frequency must be unique.
Audio Stream URL required	Direct MP3/AAC stream URL (Icecast/Shoutcast compatible).
Genre / Tagline	Short label shown under the station name.
Cover Logo Image	Upload from the Media Library or auto-fill from a directory search result.

Editing & deleting

Use the Edit button on any row to load it back into the form, or the Delete button to remove it. Play counts and likes are preserved when you edit an existing station.

Stream qualityWhen you paste a stream URL, the plugin probes and displays the detected bitrate so you can gauge audio quality before saving.

6. Station Directory Search

Inside the Stations tab there is a Quick API Search box. Type keywords (e.g. Jazz, BBC, Classical) and pick a result to auto-fill the station form.

Free Directory (default)

Uses the community Radio-Browser directory. No account or key is required. Search results are cached for 6 hours to keep the service responsive and reduce outbound requests.

Premium (RapidAPI) — optional

An optional richer source powered by the "60K Radio Stations" API on RapidAPI. To enable it:

Create an account at RapidAPI and subscribe to a radio stations API.
Copy your X-RapidAPI-Key.
Paste it under Radio Tuner → General Settings → RapidAPI Key and save.
The Premium source toggle in the search box becomes active.

Premium is entirely optionalThe plugin is fully functional without any RapidAPI key. Leave the field blank to use only the free directory and your own stations.

7. General Settings

Found under Radio Tuner → General Settings.

Setting	What it does
Enable Frontend Tuner Player	Shows/hides the floating footer player site-wide.
Player Layout Width Mode	Centered (max 1200px) or Full width (stretches with 40px margins).
Enable Seamless Page Navigation (PJAX)	Intercepts page transitions and loads pages via AJAX so audio never stops. If disabled, playback resumes on reload via saved session state.
Auto-resume playback on page load	If the visitor was listening before a reload/transition, the player attempts to resume automatically.
Tuner Theme Accent Color	Global accent for the needle, volume levels, and highlighted controls.
RapidAPI Key / Host	Optional premium search credentials (see section 6).

Browser autoplay noteModern browsers block audio autoplay until the user interacts with the page. "Auto-resume" works best after the first click/tap; this is a browser policy, not a plugin limitation.

8. Designs & Customization

Go to Radio Tuner → Choose Design to pick one of six layouts:

LightDark VU LightVU Dark FM-AM LightFM-AM Dark

Select a design, click Activate Selected Design, then use Customize to fine-tune it. Each design stores its own independent settings:

Option	Description
Accent Color	Per-theme highlight color.
Background Color	Base color of the player card.
Opacity	Card transparency (0–100%).
Blur	Backdrop blur strength behind the card (glassmorphism).
Digit Font Family	Font used for the large frequency read-out. Choose a bundled font or upload a custom one.
Digit Font Size	Size of the frequency read-out.

Uploading a custom digit font

Set Digit Font Family to Custom and provide the URL of a .ttf font. TTF uploads are enabled in the Media Library by the plugin. Click Save & Apply to see it live.

FM-AM designs onlyOnly the FM-AM Light and FM-AM Dark designs expose the AM band and its separate AM station list.

9. Equalizer & VU Meters

The player includes an 8-band graphic equalizer built on the browser's Web Audio API (bands: 60, 150, 400 Hz, 1K, 2K, 2.4K, 6K, 15K). Drag the handles to shape the sound; an indicator shows whether the EQ is active.

The VU and FM-AM designs additionally render animated analog VU meters that react to the audio signal in real time.

Cross-origin audioThe equalizer and VU meters analyze the audio signal, which requires the stream server to allow cross-origin (CORS) access. Some radio streams do not send CORS headers; in that case audio still plays, but the meters/EQ analysis may be limited. This depends on the stream provider.

10. Troubleshooting

The player doesn't appear on the front end

Make sure Enable Frontend Tuner Player is on, or that you placed the [radio_tuner_player] shortcode on the page.
Some page builders strip footer hooks — in that case use the shortcode instead.
Clear any caching/optimization plugin cache after activating.

A station won't play (works elsewhere)

HTTPS "mixed content" blockIf your site runs on HTTPS but a station's stream URL is plain http://, the browser blocks it as insecure mixed content. Fix: use the station's https:// stream URL if the provider offers one. Many directory search results already provide a resolved HTTPS URL.

Audio stops when navigating between pages

Enable Seamless Page Navigation (PJAX) in General Settings.
If your theme has an unusual markup structure, PJAX may fall back to a reload; enable Auto-resume playback as a backup.

Playback doesn't auto-start

Browsers require a user interaction (click/tap) before audio can play. This is expected behavior and cannot be bypassed by any plugin.

Equalizer or VU meters look inactive

See the cross-origin (CORS) note in section 9 — analysis depends on the stream server allowing it.

Custom font not showing

Confirm the font is a valid .ttf file and the URL is publicly reachable.
Re-save the design with Save & Apply and hard-refresh the page (Ctrl/Cmd + Shift + R).

11. Credits & Licenses

All assets below are bundled locally with the plugin. This item is released under the GPLv2 or later license. Third-party assets retain their original licenses:

Fonts

Font	Author	License
Outfit	Rodrigo Fuenzalida / Google Fonts	SIL Open Font License 1.1
Orbitron	Matt McInerney / Google Fonts	SIL Open Font License 1.1
Roboto	Christian Robertson / Google Fonts	Apache License 2.0
Roboto Condensed	Christian Robertson / Google Fonts	Apache License 2.0
Roboto Mono	Christian Robertson / Google Fonts	Apache License 2.0

Icons

Library	Version	License
Font Awesome Free	6.4.0	Icons: CC BY 4.0 · Fonts: SIL OFL 1.1 · Code: MIT (license)

Sound effect

Sound	Author	License
"FM radio tuning sweeps" (Freesound #140157)	copyc4t	Creative Commons Attribution 4.0 (CC BY 4.0)

AttributionTuning sweep sound "FM radio tuning sweeps" by copyc4t, licensed under CC BY 4.0, via Freesound.org.

External data services

Service	Use	Notes
Radio-Browser API	Free station directory search	Community project, no API key required.
60K Radio Stations API (via RapidAPI)	Optional premium search	Requires the buyer's own RapidAPI key. Disabled by default.

PrivacyNo visitor data is sent to third parties by default. External requests only happen when an administrator actively uses the station directory search in the dashboard, or when the optional "now playing" metadata feature fetches song titles from a stream you configured.

12. Changelog

1.1.8
- Security: admin station search results are sanitized server-side and rendered safely.
- The station directory search now returns HTTPS streams only.
- Security: the "now playing" endpoint only accepts stream URLs of saved stations.
- Fixed play/like counters for AM stations.
- Frontend assets are loaded only when the player is actually rendered.
- All default station streams switched to HTTPS; declared WordPress 7.0 compatibility.
- Removed debug console logging from production scripts.

1.1.7
- Hardened all admin and public AJAX handlers (nonce + wp_unslash + sanitization).
- Restricted the "now playing" endpoint to stations saved in the tuner and blocked private/internal hosts (SSRF hardening).
- Added 6-hour transient caching for station directory search results.
- Switched local JSON reading to wp_json_file_decode().
- Removed bundled API credentials; fully works out of the box.
- Coding-standards and security cleanup.