Skip to main content

​
Studio inputs

Your studio encoder sends audio to Liquidsoap, which processes it and feeds the output chain.
InputPortProtocolFormat
Primary8010Icecast sourceMP3 CBR 320 kbps
Fallback8011Icecast sourceMP3 CBR 192 kbps
Emergency—Local fileemergency-audio/fallback.mp3
The fallback chain activates automatically: primary, then fallback, then emergency file. No manual intervention is needed.

​
Icecast endpoints

All Icecast mount points are available through the Nginx reverse proxy under /listen/.
MountFormatBitrateURL
/stream-mp3-128MP3128 kbpshttps://<host>/listen/stream-mp3-128
/stream-mp3-192MP3192 kbpshttps://<host>/listen/stream-mp3-192
/stream-mp3-320MP3320 kbpshttps://<host>/listen/stream-mp3-320
/stream-aac-128AAC128 kbpshttps://<host>/listen/stream-aac-128
/stream-aac-192AAC192 kbpshttps://<host>/listen/stream-aac-192
/stream-ogg-128Ogg Vorbis128 kbpshttps://<host>/listen/stream-ogg-128
Replace <host> with your ICECAST_HOSTNAME value.

​
HLS endpoint

For mobile and web players that need adaptive bitrate streaming: 
https://<host>/hls/live.m3u8
The HLS stream includes three AAC quality tiers. Players automatically select the best quality for the listener’s connection.

​
Choosing an endpoint

Use caseRecommended endpoint
Web player (general)/listen/stream-mp3-128 or /listen/stream-aac-128
High-quality listening/listen/stream-mp3-320
Mobile app/hls/live.m3u8 (adaptive bitrate)
Low bandwidth/listen/stream-mp3-128
Open-source codec/listen/stream-ogg-128

​
Admin interface

The Icecast admin panel is available at: 
https://<host>/icecast-admin/
Log in with the ICECAST_ADMIN_USER and ICECAST_ADMIN_PASSWORD from your .env file. The admin panel shows raw listener statistics, mount point status, and connected sources.