HTML5 Audio Player
The MediaCP HTML5 Audio Player works in all modern browsers. It supports native HTML5 streaming, SSL, and comes in three sizes:
• Large
• Small
• Compact
The player is exclusive to MediaCP and cannot be used with external/non-MediaCP streams.
Primary Features
- Automatic Album Art (iTunes or LastFM)
- Fallback custom background when no album art is available
- Direct player links
- Mount point selection
- Listener count display
- Domain restrictions (only play on allowed websites)
The audio player is heavily cached using nginx and Redis, allowing it to handle thousands of visitors efficiently.
HTTPS / SSL & Stream Proxy
The player works with:
• Native SSL (Shoutcast or Icecast)
• MediaCP Stream Proxy
If Stream Proxy is enabled on a service, the player uses it automatically.
The proxy is powered by nginx proxy_pass and adds minimal CPU overhead.
When Stream Proxy is used automatically
- Shoutcast 2.5 (no SSL support in the server)
Autoplay
Due to modern browser policies (Chrome, Edge, Brave), autoplaying audio is restricted.
Autoplay is only possible when:
- Audio is muted
- The user has interacted with the website
- The user has previously played media on the site
Since muted audio streams confuse users, the player offers Attempt Autoplay, which:
• Tries to start playback at 50% volume
• Works only if the visitor already interacted with the page
More on the browser policy:
https://developers.google.com/web/updates/2017/09/autoplay-policy-changes#mei
Mount Points
The player streams the default mount point set in MediaCP.
If multiple mount points exist, the player shows a dropdown so users can switch streams (e.g., multiple bitrates).
Album Covers
Album covers display automatically using:
• iTunes
• Last.fm
If no art is available, the configured Player Background image is shown instead.
You can disable album covers in:
Player Configuration → Display Options → Covers
Player Configuration
When you are logged into MediaCP, the player displays a configuration icon that gives you access to all player settings.
Permitted Domains
You can restrict the audio player so it only loads on approved domains.
Examples of valid entries:
mediacp.net
mydomain.com
example.org
Do NOT include:
✗ http://
✗ https://
✗ slashes or paths
✗ ports
This restriction uses:
Access-Control-Allow-Origin + the player’s JSON configuration URL.
If a domain is not in the allowed list, the browser automatically blocks access to the config, and the player will not load.
Learn more: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin
