How to Listen
To start listening, click any station's [Web Player] link or [Server URL] link. The Web Player launches an in-browser player, while Server URL lets you stream directly in your preferred media player.
You can use Chrome, Firefox, Edge, or Safari. If you experience playback issues, ensure your browser allows insecure HTTP audio streams or use our secure proxy-based player coming soon.
Supported Media Players
π₯οΈ Desktop Platforms
- Windows:
- VLC Media Player β Supports .MP3 and .AAC streams. Download from videolan.org. Open VLC β Media β Open Network Stream β paste the stream URL.
- Winamp β Classic player with Shoutcast support. Great for legacy streams.
- MediaMonkey β Ideal for organizing stations in a music library.
- macOS:
- VLC for Mac β Fully supports all our stream formats.
- iTunes (Music app) β Paste the stream URL via File β Open Stream.
- Linux:
- VLC β Install via your distro's package manager.
- Audacious β Lightweight and stream-friendly.
- Rhythmbox β Default on many GNOME desktops.
π± Mobile Platforms
- iOS (iPhone/iPad):
- VLC for iOS β Free app with full stream support.
- myTuner Radio β Easy station search and bookmarking.
- Simple Radio β User-friendly with fast access to streams.
- Android:
- VLC for Android β Plays all formats including MP3/AAC streams.
- RadioDroid β Open-source with Icecast/Shoutcast support.
- XiiaLive β Advanced buffering options and custom URL support.
π§ Pro Tips
- Use the [Server URL] link on each station to copy and paste into your player.
- If the stream doesnβt play, check if your app supports HTTP streams or try switching to HTTPS if available.
- Always ensure volume is up and device sound isn't muted!
CasterClub-YPPlayer/1.0
The CasterClub-YPPlayer/1.0 is our custom web-based player specifically developed for use on yp.casterclub.com. It was engineered to support over 13,000 active radio streams while maintaining minimal latency and compatibility with various formats like MP3, AAC, and AAC+.
This player identifies itself via a unique User-Agent string: CasterClub-YPPlayer/1.0
. This signature helps us trace playback activity in server logs, monitor feature engagement, and maintain compatibility across partner streaming servers. If you're a station owner and see this in your access logs, it means someone is tuning in from our directory!
π Player Features
- Supports HTML5 audio playback for both MP3 and AAC streams
- Lightweight with minimal dependencies
- Auto-title updates when CORS headers are present
- Click-to-play UX with failover support for [Server URL]
- Auto-pause on tab switch (coming soon)
β οΈ Known Limitations
- Chrome and Edge may block autoplay or insecure HTTP content without special settings
- Safari does not support cross-origin stream titles for some servers
- Firefox offers the most consistent playback and should be preferred
We are working on releasing secure reverse proxy endpoints to ensure HTTPS compatibility across all major browsers. Until then, for best results use the latest version of Firefox on macOS, Windows, or Linux.
AI-Assisted Discovery
CasterClub is integrating AI to help match you with stations you love based on your listening behavior, preferred genres, and real-time mood.
We will soon launch AI-generated recommendations, automatic smart playlists, and audio fingerprinting to find hidden gems from our vast directory of over 13,000 stations.
The Future of Media Play
We envision a future where every listener has a personalized audio dashboard powered by live content, social feedback, AI scoring, and decentralized station hosting.
Expect features like voice-activated playback, in-browser DJ booths, and crowd-powered rankings and reviews.
π‘ CasterClub YP Directory
Version: 1.1.1-alpha
Release Date: May 1, 2025
π§ Overview
CasterClub's YP Directory is a modern, community-driven streaming radio directory built to showcase thousands of live internet radio stations from around the world. Inspired by the legacy of SHOUTcast and Icecast directories, this project provides webcasters with a fast, customizable, and feature-rich platform for station discovery, promotion, and real-time stream insights.
This is the Alpha release of the projectβs frontend UI and search infrastructure, representing a major leap from basic stream listings to an immersive web interface.
π― What It Does
- π Aggregates and displays 13,000+ Icecast-compatible radio stations.
- π Offers dynamic search, genre filtering, bitrate & format sorting.
- π Real-time listener metrics, online/offline detection, and station reliability indicators.
- π§ Intuitive sorting by listeners, format, bitrate, uptime, and more.
- β‘ Interactive popup web players with real-time song updates.
- π‘ Live VU meters, stream stats, and station info modals per mount.
- π± Responsive and mobile-optimized (in-progress).
π οΈ Tech Stack
- PHP 8.x + modern object-oriented parsing for Icecast JSON
- AJAX polling of
/status-json.xsl
for dynamic song updates - Session-based song history tracking
- Vanilla JavaScript for live DOM updates and event logs
- Pure CSS3 for responsive layout and styled UI (no frameworks)
- No external dependencies for max speed and security
β Whatβs New in v1.1.1-alpha
π Unified Updates Across directory.php
and index.php
-
ποΈ Dynamic Sort Controls:
- Replaced legacy text links with fully styled
<button>
-based sort bar - Interactive arrows (β²βΌ) for ascending/descending toggling
- Fields: Listeners, Bitrate, Name, Peak, Online, Reliability, Quality
- Replaced legacy text links with fully styled
-
π Pagination Styling:
- Button-style navigation with highlight on active page
- Jump-to-page inline form
- Unified visual language across top and bottom sections
-
π Enhanced Filter Controls:
- Dropdowns for genre, format, bitrate using consistent styling
- Auto-sync of recommended bitrate/format pairs
-
βοΈ Cache Busting:
- Web player popup URLs include cache-busting timestamps for freshness
-
π§ Directional Sort Logic:
- Server-side validation for
sort
anddirection
params - Fixed bug with undefined
$direction
in early sort rendering
- Server-side validation for
-
π Filter Tips + Generation Stats:
- Pro tip block added above listings
- Gray-text styling matches lower player UI
- Page load generation timer display
-
π¨ Styling Enhancements:
- Improved button aesthetics (rounded, hover states)
- Consistent visual spacing and mobile padding
- Custom color palette: deep cyan + neon green + yellow accents
π Security and Performance
To protect integrity and performance:
- Input parameters are fully sanitized (
$_GET
inputs) - No user-submitted content stored in this phase
- Session-based song tracking uses
$_SESSION
to avoid localStorage exposure - Popup blocker detection + fallback handling
π§ͺ Upcoming Features
- Full station profile pages under
/wp.casterclub.com
- User accounts and favorites
- Dark mode toggle
- Optional WebSocket streaming updates
- Standalone JSON API for embeddable widgets
- Station embed preview + player customization tools
π License
This release is part of the CasterClub ecosystem. For now, this is an internal preview build under private license. Public license details will be provided in the beta release.
π Want to Contribute?
Feature requests, bug reports, and feedback are welcome via the upcoming CasterClub GitHub organization.
Contact & Social
Email: git@casterclub.com
GitHub: github.com/casterclub
Social Media
- π Facebook: facebook.com/officialcasterclub
- πΈ Instagram: @casterclub.ai
Powered By
MediaCast1
- π Facebook: facebook.com/officialmediacast1
- πΈ Instagram: @mediacast1.ai