What is Quikcast? ​

Quikcast is a server that sends live audio from an encoder (the software that captures your show) to many listeners (people with a player). If you have used Icecast or SHOUTcast, you know the idea. Quikcast does the same job with one small program and one configuration file.

The four words you need ​

WordWhat it means
Source or encoderThe program that sends audio to Quikcast, such as BUTT or Liquidsoap.
MountOne stream, identified by a URL path like /radio.mp3. An encoder feeds a mount; listeners play it.
ListenerAnyone playing a mount.
RelayQuikcast pulling a stream from somewhere else and publishing it on one of your mounts.

The full list is in the glossary.

What you get ​

  • All the common formats. MP3, AAC, Opus, Vorbis (Ogg) and FLAC.
  • Backups. If a source drops, new listeners can be sent to a backup mount automatically.
  • Relays. Rebroadcast an Icecast or SHOUTcast stream, with backup upstreams if the first one fails. Audio-only HLS upstreams are supported but experimental.
  • HLS. Serve the segmented streams that browsers and phone apps prefer.
  • Access control. Allow or block listeners by IP, country or player, or use expiring links your own app signs.
  • HTTPS. Built in, with certificate renewal on a config reload. Or put a proxy in front.
  • A console and an API. A web console for live status and a public status page, plus a JSON API and Prometheus metrics for automation.
  • Safe to operate. Memory use is bounded, a slow listener can never slow down others, and a bad config change is refused instead of half-applied.

What it does not do ​

  • It does not encode or mix audio. Quikcast forwards audio that is already encoded. Use BUTT, Liquidsoap or FFmpeg to produce it.
  • It is not an auto-DJ. Scheduling, playlists and live-over-automation switching belong in a tool such as Liquidsoap (see below).
  • It does not store history. Listener statistics live in memory and reset on restart. Scrape the metrics if you want long-term graphs.
  • It has no user accounts. Access is controlled by passwords, network rules and signed links that your own application issues.

How it fits with Icecast and Liquidsoap ​

If you are coming from Icecast, encoders connect the same way, so BUTT, Liquidsoap and FFmpeg settings carry over. Configuration is different: Quikcast uses TOML, and unknown or misspelled settings are rejected at startup instead of being silently ignored.

If you use Liquidsoap, keep it. Liquidsoap decides what plays (playlists, a live DJ taking over, jingles) and Quikcast delivers the result to your audience.

Where next? ​

  1. Install Quikcast
  2. Run the quickstart
  3. Connect your real encoder