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_mountsreplaces the fixed cap of 64 static mounts. The default stays 64 and it accepts up to 1,024; raiseretained_audio_budgetalong with it. Replicas follow the same setting. See Limits. - Mounts can hide their listener count.
hide_listener_count = truekeeps 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/listclientsand/admin/killclientand a public/status-json.xslon 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/bansrefuses an address or range for a set time and can disconnect its listeners;POST /api/revocationskills one leaked signed link without rotating the key;listeners_per_iplimits how many listeners one address may hold (globally or per mount, answered with429); andasns_allowandasns_denyblock whole networks using a bundled ASN database, or one you supply withasn_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, andbind_ip = truesigns 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_mountsnow accepts["*"], and when it is left out amodeof"public"or"both"behaves the same way, so streams that encoders create withallow_dynamic_mountsappear on the page while they are live. Before, only mounts named inpublic_mountswere shown and encoder-created mounts could not be named at all. A list of paths still limits the page, andpublic_mounts = []shows nothing. Withmode = "private"nothing is shown unless you writepublic_mountsdown. If you run a public page withpublic_mountsomitted, it now lists all of your mounts; addpublic_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.5andmp4a.40.29as well asmp4a.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 anddirectorystill 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 asHLS name, and feed the listener history graph. HLS has no connection to count, so these are estimated from recent requests./api/statsgainsactive_hls_listeners, which is already included inactive_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./consoleis now a reserved mount path too. A proxy that strips a prefix should forward/28000/consoleas/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] modeaccepts"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/statusalso returnspublic_url,listen_portandtls, and each stream abitrate_kbps. - "Stop accepting connections". The console calls draining by what it does. The API and
/drainendpoint 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/metadataand the legacy/admin/metadata.xslon 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 getting404 Not Found. Same source username and password, samemode=updinfo,mount,songandcharsethandling, andartistplustitleare combined as "artist - title" whensongis 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 = truelets 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 withallowed_ips, can be served over HTTPS withtls = true, and throttles failed sign-ins (10 per minute per client, then429). 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}/listenerslists 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/hlsandGET /api/hls/{stream}now reportactive_sessionsandsession_timeout_seconds. New setting:[hls] directory_session_timeout_secs(default 30). - Release downloads now include a
manifest.jsonwith 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_durationandintro. 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
.m3uplaylist 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_durationsets 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,.plsand.xspfplaylists 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-Rangesupport. - 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.