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.

toml
[icecast_admin]
username = "admin"
password_file = "secrets/icecast-admin"

Reload the configuration (send SIGHUP, see the CLI reference) and check it:

sh
curl -u "admin:$(cat secrets/icecast-admin)" \
  "http://127.0.0.1:8000/admin/listclients?mount=/radio.mp3"

What is served ​

PathUse
/admin/statsTotals and per-mount listeners, artist, title, bitrate, listen URL
/admin/listmountsLive 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.xslPublic 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.

  1. Create the mount in quikcast.toml with the source password your encoder or panel will use.
  2. In the client, add a remote Icecast server with Quikcast's host and port, the mount, and the admin user and password above.
  3. 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.