Streams and mounts
A mount is one stream: a URL path, a password for the encoder that feeds it, and optionally its own listener limit and access rules. One server can run many.
Add more streams
Each [[mounts]] block adds a stream:
[[mounts]]
path = "/main.mp3"
secret_file = "secrets/main-source"
[[mounts]]
path = "/talk.mp3"
secret_file = "secrets/talk-source"
listener_limit = 100Listeners play http://your-server:8000/main.mp3 and http://your-server:8000/talk.mp3. You can have up to 64 mounts by default; raise limits.max_mounts (and retained_audio_budget) for more.
You can add or remove a [[mounts]] block while the server runs: edit the file and send SIGHUP (see reload). New streams are available at once and others are not interrupted. Removing a block disconnects that stream's encoder and listeners, and the log names it. A reload is refused, and the old configuration kept, if the new path is already used by an encoder-created stream or the memory limits no longer fit.
Use a different password per mount
Give each stream its own secret file. Then a leaked password only lets someone take over that one stream.
Path rules
- Start with
/, with no trailing/. Nested paths such as/stations/jazzare fine. - Letters, digits and
/ . _ - ~only. Paths are case-sensitive. /api,/admin,/internal,/health,/metrics,/hls,/uiand/consoleare reserved.
Playlist files
Add .m3u, .pls or .xspf to any mount path to get a playlist that points at the stream. /stations/jazz.m3u returns a one-entry playlist for /stations/jazz, ready to open in VLC, iTunes or a phone.
- The stream URL is built from the request's
Hostheader, usinghttpswhen TLS is enabled. A request without a usableHostgets400. - Playlists follow the mount's access rules and signed-URL auth. A valid
expiresandsigon the playlist URL are carried into the stream URL inside it, so the same signed link works for both. - A mount literally named
/jazz.m3utakes priority over the playlist rule.
One source per mount
One encoder per mount. A second one is refused with 409, so a forgotten test encoder can never replace your real show. When the encoder disconnects, its listeners are disconnected too, and players reconnect when the next session starts.
For a live DJ takes over from the playlist workflow, see How it fits with Icecast and Liquidsoap.
Limit listeners
By default every mount can have up to 10,000 listeners, within the server-wide limit. Cap one mount with listener_limit:
[[mounts]]
path = "/small.mp3"
secret_file = "secrets/small-source"
listener_limit = 25 # 0 means no per-mount capServer-wide and default limits live under [limits]; see Capacity and limits.
Let encoders create streams on demand
Sometimes you do not know the stream names ahead of time, for example when each presenter gets their own mount. Turn on dynamic mounts and give them a shared credential:
[sources]
allow_dynamic_mounts = true
username = "source"
secret_file = "secrets/dynamic-source"
[sources.defaults]
name = "Community Radio"
genre = "Various"Now an encoder that authenticates with that password can broadcast to any free path, for instance /dance. The mount exists while the source is connected and disappears once its last listener leaves. Nothing is written to your config. Mounts you list under [[mounts]] always take precedence.
[sources.defaults] provides the station name, description, genre and website for any source that does not send its own.
Station name and genre
For listed mounts, your encoder (BUTT, Liquidsoap) sends the name, genre and song title. Quikcast passes them to players that ask for them. You do not configure these per mount in the config file.
Supported formats
| Format | Content type the encoder sends | Notes |
|---|---|---|
| MP3 | audio/mpeg | Works everywhere. |
| AAC (ADTS) | audio/aac, audio/aacp | AAC-LC, HE-AAC and HE-AACv2. |
| Ogg Vorbis, Opus, Ogg FLAC | audio/ogg, application/ogg | Titles travel inside the stream. |
| FLAC | audio/flac | Native FLAC, for lossless streams. |
Quikcast does not convert between formats: each listener gets exactly what the encoder sent.