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:

toml
[[mounts]]
path = "/main.mp3"
secret_file = "secrets/main-source"

[[mounts]]
path = "/talk.mp3"
secret_file = "secrets/talk-source"
listener_limit = 100

Listeners 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/jazz are fine.
  • Letters, digits and / . _ - ~ only. Paths are case-sensitive.
  • /api, /admin, /internal, /health, /metrics, /hls, /ui and /console are 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 Host header, using https when TLS is enabled. A request without a usable Host gets 400.
  • Playlists follow the mount's access rules and signed-URL auth. A valid expires and sig on the playlist URL are carried into the stream URL inside it, so the same signed link works for both.
  • A mount literally named /jazz.m3u takes 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:

toml
[[mounts]]
path = "/small.mp3"
secret_file = "secrets/small-source"
listener_limit = 25   # 0 means no per-mount cap

Server-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:

toml
[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 ​

FormatContent type the encoder sendsNotes
MP3audio/mpegWorks everywhere.
AAC (ADTS)audio/aac, audio/aacpAAC-LC, HE-AAC and HE-AACv2.
Ogg Vorbis, Opus, Ogg FLACaudio/ogg, application/oggTitles travel inside the stream.
FLACaudio/flacNative FLAC, for lossless streams.

Quikcast does not convert between formats: each listener gets exactly what the encoder sent.