🎧 CasterClub WebPlayer

Version: 2.0.2b
Release Date: TODAY :)

🧪 Browser Compatibility

For the best experience on yp.casterclub.com, we recommend using the latest version of Firefox.

• ✅ Firefox — Best performance on macOS, Linux, and Windows
• 🟡 Brave, Chrome, Vivaldi — Functional, but may have media autoplay or cross-origin restrictions
• 🟥 Safari and Edge — May require additional permissions or settings for audio playback

Firefox provides the most consistent support for Icecast streaming, embedded HTML5 audio, and CORS handling across all major platforms.

🎯 Overview

The CasterClub WebPlayer is a modern HTML5 audio interface purpose-built for Icecast-based radio stream playback. It supports real-time VU metering, mount point selection, and fully dynamic status polling with song history and status logging, offering users a seamless broadcast experience in the browser.

🛠️ What's New in 2.0.2b

🔊 Player Interface Enhancements

• Increased "Now Playing" status font to 16px, and the song title to 14px for visibility
• Improved VU meter stability by fixing .vu-rms-value container width
• Static decibel readout area prevents visual jitter in the bars

🎶 Song Title Streaming Fixes

• Polling interval to status-json.xsl increased from 5s → 13s to reduce load
• Improved song title detection: now only updates when a true title change is confirmed
• Fixed issue where previous songs reappeared due to polling race conditions
• Updated window title to reflect the currently playing title without flicker

📈 Song History Improvements

• Song history expanded to 15 songs per session
• Entries now show:
  • Full timestamp in d/m/Y - h:i:s AM/PM format
  • Bold timestamp, regular station + song
  • Numbered list for readability

🔧 Mount Selector Enhancements

• Each dropdown entry now shows:
  • 🟢/🔴 Online/offline dot
  • AutoDJ or Live
  • Mount number + exact filename
  • Format, bitrate, listener stats
• All entries reflect current mount accurately with no HTML-in-<option> issues

🐞 Event Log Console

• Event Log tab now receives:
  • Tab change logs
  • Play/Pause/Stop/Volume/Reload events
  • Song title change events
  • Mount switch messages
• Unified timestamp format on all events
• One log tab per mount index (scoped correctly)

🧭 Tab System Overhaul

• Fully tabbed layout below player:
  1. Status
  2. Server Information
  3. Station Details
  4. Song History
  5. Event Log
• Clean separation between data panes for clarity

🌐 Compatibility & Proxy Issues

• SSL Certificate Issues: Some Icecast servers still use self-signed or expired SSL certs, causing playback failures or blocking in Chrome-based browsers. Firefox handles these more gracefully.
• CORS Problems: Older Icecast versions do not send proper Access-Control-Allow-Origin headers, which may prevent status polling, title updates, or mount switching from working in modern browsers.
• Cache Expiry Bypass: New updates ensure that polling requests include cache-busting parameters to bypass stale results, especially on long uptime servers.
• Proxy Requirements: To support strict HTTPS clients, backend NGINX or Apache servers should implement proxy_pass with rewritten headers and proxy_set_header directives for Origin, Host, and Referer.
• Forward Compatibility: Player is being prepped for integration with secure reverse proxies and certificate pinning methods to ensure reliable streaming even on Chrome, Safari, and Edge.

🔐 Session Integration

• Stream metadata and song history are session-persistent
• PHP sessions initialized cleanly at top of script
• IcecastParser now supports session caching of parsed data

📌 Known Issues

• No full mobile responsiveness yet (planned in 2.0.3b)
• Mount detection via basename may fail for complex URL schemes
• Lyrics and album art support not yet implemented

📄 License

Private build under internal review. Not for public redistribution or embedding until production release.