Icecast-compatible admin API
Control panels and monitoring tools built for Icecast read listener counts and listener IPs from Icecast's admin API. Quikcast serves the same API, so it can take Icecast's place as a remote server without losing those numbers.
Turn it on
Add a credential for the client. The password must be at least 16 characters.
[icecast_admin]
username = "admin"
password_file = "secrets/icecast-admin"Reload the configuration (send SIGHUP, see the CLI reference) and check it:
curl -u "admin:$(cat secrets/icecast-admin)" \
"http://127.0.0.1:8000/admin/listclients?mount=/radio.mp3"What is served
| Path | Use |
|---|---|
/admin/stats | Totals and per-mount listeners, artist, title, bitrate, listen URL |
/admin/listmounts | Live mounts and listener counts |
/admin/listclients?mount=… | Each listener's IP, user agent, seconds connected and ID |
/admin/killclient?mount=…&id=… | Disconnects one listener |
/status-json.xsl | Public JSON status with no login. Clients use it as a fallback when /admin/stats fails |
Listener IDs are numbers, as in Icecast. A title written "Artist - Title" is reported as separate artist and title. Behind a proxy, set up [trusted_proxies] so the IPs reported are the real listeners', not the proxy's.
Point a client at it
Many Icecast clients log in as the user admin with no way to change it, so leave username at its default. The password a client sends must match the [icecast_admin] password. Because Quikcast requires at least 16 characters, an old short Icecast password will not work; set a new one in the client too.
- Create the mount in
quikcast.tomlwith the source password your encoder or panel will use. - In the client, add a remote Icecast server with Quikcast's host and port, the mount, and the admin user and password above.
- Check that listener counts and the listener list appear.
Security
/admin/listclients exposes listener IP addresses, so treat the credential as sensitive. /status-json.xsl is public and shows only counts and titles; use hide_listener_count on a mount to report 0. The routes share the public port, as they do in Icecast. If Quikcast is on the internet, have your proxy or firewall allow /admin/ only from the client's address. Failed logins from one address are throttled with 429.
Not supported
/admin/moveclients, /admin/fallbacks and the per-mount web admin pages are not implemented. Manage mounts in the config file or the management API.