Documentation

Setup, configuration, troubleshooting

SkipSeek Radio (WordPress plugin)

Install from the WordPress repo

  1. WordPress admin → Plugins → Add New
  2. Search for "SkipSeek Radio"
  3. Install Now → Activate

Or install from .zip (Pro buyers)

  1. Download the .zip from your purchase email
  2. WordPress admin → Plugins → Add New → Upload Plugin
  3. Choose the .zip → Install Now → Activate

Configure

  1. Settings → SkipSeek Radio → General
  2. Paste your stream URL into Default Stream URL. For AzuraCast, use the public-page URL (e.g. https://your-server/public/your-station) — the plugin auto-fetches station name, cover art, and live metadata.
  3. For non-AzuraCast Icecast/Shoutcast: paste the raw audio URL ending in .mp3, .aac, etc.
  4. Save.
  5. Add [skipseek_radio] shortcode or the SkipSeek Radio Gutenberg block to any page.

Activate Pro

  1. Buy at /wp-plugin — license key arrives by email within seconds
  2. WordPress admin → Settings → SkipSeek Radio → License
  3. Paste the key (format SSRP-XXXX-XXXX-XXXX-XXXX) → Activate
  4. Pro features unlock immediately in the General + Pro Features tabs

SkipSeek AzuraCast Skin

Install

  1. Buy at /azuracast-skin — files arrive by email within seconds
  2. Unzip; you get skin.css and skin.js + INSTALL.md
  3. AzuraCast admin → System Administration → Custom Branding
  4. Paste skin.css into "Custom CSS for Public Pages" → Save
  5. Paste skin.js into "Custom JS for Public Pages" → Save

Configure

The top ~80 lines of skin.js are a plain-text CONFIG block. Edit your values to the right of each = sign:

defaultStation     = calm
rotationStations   = calm,focus,sleep
button3            = Checkz | https://checkz.io
button4            = Globez | https://globez.io
facebook           = yourhandle
creditName         = Your Station
creditUrl          = https://your-site.com

Save in AzuraCast, hard-refresh your public player URL (/public/your-station) — skin is live.

Troubleshooting

Player shows but won't play audio

Verify the stream URL works directly in a browser tab. Browsers block autoplay without a user click — the play button overlay should fade away when you click the album art.

Rotation buttons show wrong stations

Check the Rotation stations whitelist in Settings. If blank, the plugin auto-discovers every station on your AzuraCast install. If you only want specific stations to rotate, list their slugs here comma-separated.

License activation fails

Make sure your site can reach https://skipseek-stripe-webhook.skipseek.workers.dev. Some managed hosts block outbound HTTPS; whitelist that domain in your host's firewall. If the key format error appears, copy the key fresh from your purchase email — no spaces, all uppercase.

AzuraCast skin doesn't load after paste

Hard-refresh the public player URL (Cmd-Shift-R). Check browser DevTools console for syntax errors — most often a stray character if you edited the CONFIG block. Cloudflare in front of AzuraCast can cache the old CSS/JS for 31 days; bypass via a query string (?v=2) on first refresh.