Changelog ​

What changed in each release of Quikcast. Install or update with the install script or qc update.

0.3.3 (2026-11-19) ​

  • The mount limit is configurable. limits.max_mounts replaces the fixed cap of 64 static mounts. The default stays 64 and it accepts up to 1,024; raise retained_audio_budget along with it. Replicas follow the same setting. See Limits.
  • Mounts can hide their listener count. hide_listener_count = true keeps a mount's listener count off the public status page. When any mount sets it, the server-wide total is left off too, because it would reveal the hidden count.
  • Icecast-compatible admin API. A new [icecast_admin] table serves /admin/stats, /admin/listmounts, /admin/listclients and /admin/killclient and a public /status-json.xsl on the streaming listener, so Icecast control panels and monitoring tools can use Quikcast as a remote Icecast server and still read listener counts, IPs and user agents. Off by default. See Icecast-compatible admin API.

0.3.2 (2026-11-17) ​

  • Listener bans. New runtime controls for dealing with abuse without a reload: POST /api/bans refuses an address or range for a set time and can disconnect its listeners; POST /api/revocations kills one leaked signed link without rotating the key; listeners_per_ip limits how many listeners one address may hold (globally or per mount, answered with 429); and asns_allow and asns_deny block whole networks using a bundled ASN database, or one you supply with asn_database. Bans and revocations are held in memory and expire on their own. See Limit who can listen and the management API.

  • Signed URLs can roll over keys and bind to an IP address. previous_secret_files (up to four) keeps links signed with an older key working while you rotate, and bind_ip = true signs the listener's address too, so a shared link stops working elsewhere. Both are off by default and apply to mounts and HLS streams. See Signed URLs.

0.3.1 (2026-11-15) ​

  • The public status page shows every mount by default, including encoder-created ones. [ui] public_mounts now accepts ["*"], and when it is left out a mode of "public" or "both" behaves the same way, so streams that encoders create with allow_dynamic_mounts appear on the page while they are live. Before, only mounts named in public_mounts were shown and encoder-created mounts could not be named at all. A list of paths still limits the page, and public_mounts = [] shows nothing. With mode = "private" nothing is shown unless you write public_mounts down. If you run a public page with public_mounts omitted, it now lists all of your mounts; add public_mounts = [] or a list to keep the old behaviour.

0.3.0 (2026-11-13) ​

  • HE-AAC and HE-AACv2 are accepted. HLS ingest takes mp4a.40.5 and mp4a.40.29 as well as mp4a.40.2, including fragmented MP4 whose sample entry shows the doubled SBR output rate, and HLS relays unwrap fragmented MP4 that declares HE-AAC or HE-AACv2. Encoder sources sending ADTS already passed through; the docs now say so. Checked with FDK-AAC streams.
  • Fallback and overflow move AAC listeners between any AAC configurations. The mid-stream check no longer requires AAC-LC with matching profile, rate and channels; it needs only the same format, plus a whole ADTS frame to cut at. HE-AAC mounts can now fail back, and AAC-LC, HE-AAC and HE-AACv2 mounts can back each other up. MP3 is unchanged.

0.2.9 (2026-11-12) ​

  • HLS can be switched on or off by a reload. Adding or removing the [hls] table now applies on SIGHUP instead of needing a restart. Removing it answers HLS requests with 404 straight away and releases ingested streams; adding it starts HLS. Capacity settings and directory still need a restart while HLS is on.

0.2.8 (2026-11-10) ​

  • Directory HLS listeners are counted everywhere. They were only visible under the HLS page and /api/hls/<name>/listeners. They now add to the overview's Listeners total, appear in the Listeners page's dropdown as HLS name, and feed the listener history graph. HLS has no connection to count, so these are estimated from recent requests. /api/stats gains active_hls_listeners, which is already included in active_listeners.

0.2.7 (2026-11-10) ​

  • A redesigned console. A dark sidebar, a System, Light or Dark theme menu, filled icons and flatter cards. Mounts get copy and play icons, and Play becomes Stop while that mount streams. The player bar is rebuilt for live audio, with Stop and Play instead of Pause, a volume meter and a title that follows track changes. Listeners get an Info button with their exact values, Relays show the last error, and the HLS page lists directory streams with their listener sessions.
  • The console moved to /console. It was at /ui. Anything under /ui, including /ui/status, redirects to the same address under /console, so bookmarks and widgets keep working. /console is now a reserved mount path too. A proxy that strips a prefix should forward /28000/console as /console.
  • [console] is an alias of [ui]. Either table name works in the config; use one per file.
  • Status page at /, and both at once. [ui] mode accepts "both": the public status page at / and the sign-in console at /console. mode = "public" now serves the status page at / instead of /ui.
  • Play and bitrate on the status page. Live streams get a Play button that becomes Stop, show the bitrate the encoder announces, and the header shows the server version. /console/status also returns public_url, listen_port and tls, and each stream a bitrate_kbps.
  • "Stop accepting connections". The console calls draining by what it does. The API and /drain endpoint are unchanged, and it is still one-way until a restart.
  • Smaller changes. The generic 404 body now reads "Not found" instead of "Mount unavailable".

0.2.6 (2026-11-08) ​

  • Icecast-style metadata updates. GET /admin/metadata and the legacy /admin/metadata.xsl on the streaming listener now work as aliases of /api/metadata, so Liquidsoap (output.icecast), BUTT, Mixxx and other Icecast-compatible encoders can update the now-playing title instead of getting 404 Not Found. Same source username and password, same mode=updinfo, mount, song and charset handling, and artist plus title are combined as "artist - title" when song is absent. Every other /admin/... path is unchanged.

0.2.5 (2026-11-08) ​

Console behind a path prefix. When a trusted reverse proxy serves the console under a sub-path and strips it (for example /28000/ui forwarded as /ui), the proxy can send X-Forwarded-Prefix: /28000 and the console's pages, scripts, sign-in and session cookie all work under that prefix. The header is only honoured from addresses in [trusted_proxies]. See Behind a path prefix.

Calmer console.

  • The public status page is now just your streams: a dot for live or offline, the codec, and how many people are listening. A notice appears only if the server is draining or shutting down. The version number and the summary line are gone.
  • The theme control is an icon (automatic, light or dark) instead of a text label.
  • The Overview no longer shows an "Accepting connections" badge. A notice appears only when the server is draining or shutting down.
  • The System page and the diagnostics panels read like settings, not a data dump: proper labels, real dates, readable durations, capabilities as tags, and related facts grouped under a heading.
  • Smaller statistic cards on the Overview, and the dot-joined summary text under on-air mounts, in relay origins and in chart tooltips is gone.

0.2.3 (2026-11-08) ​

  • Remote management. [management] allow_remote = true lets the admin listener bind a non-loopback address so another system, such as a control panel, can read stats and manage listeners over the network. It needs a management token of at least 32 bytes, can be limited with allowed_ips, can be served over HTTPS with tls = true, and throttles failed sign-ins (10 per minute per client, then 429). Without the switch nothing changes: the admin listener still refuses non-loopback addresses.

0.2.2 (2026-11-07) ​

  • HLS listener sessions. GET /api/hls/{stream}/listeners lists the active listeners of an HLS stream served from a directory: IP address, user agent, country, first and last seen, request counts and bytes served. GET /api/hls and GET /api/hls/{stream} now report active_sessions and session_timeout_seconds. New setting: [hls] directory_session_timeout_secs (default 30).
  • Release downloads now include a manifest.json with the size and SHA-256 checksum of each file.

0.2.1 (2026-11-07) ​

  • Releases are built for Linux (x64 and arm64) only; macOS builds were dropped.
  • Release binaries are now published to Cloudflare R2.

0.2.0 (2026-11-07) ​

  • Release process: releases are started by hand and the tag is only created once CI and the builds pass. No change to the server.

0.1.2 (2026-11-07) ​

  • Primary and replica servers. A replica follows a primary's list of streams, and listeners are redirected from a busy primary to the replicas it announces. See Primary and replica.
  • fallback_when_full. Overflow listeners can be sent to a mount's fallback when it reaches its limit. See Backup streams.
  • HLS from a directory. Quikcast can serve HLS streams from a folder with [hls] directory. See HLS for browsers and apps.

0.1.1 (2026-11-03) ​

  • Maintenance release. No change to behaviour.

0.1.0 (2026-11-01) ​

  • On-demand relays. A relay can connect only while someone is listening. See Relay another station.
  • New mount options: charset, max_listener_duration and intro. An intro that does not match the live stream's format is skipped.
  • [[mount]] and [[relay]] are accepted as aliases for [[mounts]] and [[relays]].

0.0.9 (2026-10-31) ​

  • Console visual refinements.
  • A .m3u playlist is served at the bare stream URL.

0.0.8.1 (2026-10-29) ​

  • Maintenance release.

0.0.8 (2026-10-29) ​

  • New [ui] session_duration sets how long a console sign-in lasts.
  • Adding and removing [[mounts]] now applies on reload.
  • Windows builds were removed.

0.0.7 (2026-10-29) ​

  • File descriptor limits are handled gracefully.
  • .m3u, .pls and .xspf playlists are served for mounts.
  • The default retained audio budget is now 2 GiB.
  • Added ai.md, a single-file configuration guide for AI agents.

0.0.6 (2026-10-25) ​

  • TLS, PROXY protocol and listener history.
  • HLS relays.
  • Relays refuse private destinations that a public upstream points them at.
  • Docker deployment and IP list files.
  • Operator console improvements.

0.0.5 (2026-10-13) ​

  • Relay redirects and HLS If-Range support.
  • Security hardening and a refreshed operator console.

0.0.4 (2026-10-10) ​

  • Live fallback and Cloudflare proxy trust.
  • Dynamic continuous source mounts.
  • Clearer configuration error messages.

0.0.1 to 0.0.3 (2026-10-09) ​

The first releases: the management API with a drain lifecycle, FLAC and mount fallback, access controls, more HLS codecs, signed listener URLs, a small operator console, a bundled GeoIP database, and the build and release workflows.