Connect an encoder ​

An encoder captures your microphone, mixer or playlist, compresses it and sends it to Quikcast. Anything that can broadcast to Icecast works, with the same few settings.

The values you need ​

SettingValueWhere it comes from
Server typeIcecastQuikcast speaks the Icecast source protocol.
HostYour server's address, for example 127.0.0.1The machine running Quikcast.
Port8000Your listen setting.
Mount or mountpoint/radio.mp3The path of the mount.
UsernamesourceThe mount's username (default source).
PasswordThe contents of the mount's secret filesecret_file.

Which format?

The file extension in the mount name does not choose the format. What your encoder sends decides it. See the supported formats. MP3 and AAC work almost everywhere.

BUTT ​

BUTT (broadcast using this tool) is a popular free encoder.

  1. Open Settings → Main → Server → ADD.
  2. Fill in:
    • Name: anything, for example Quikcast
    • Type: Icecast
    • Address: your server address
    • Port: 8000
    • Password: your source password
    • Icecast mountpoint: /radio.mp3
    • Icecast user: source
  3. Under Audio, pick the codec (MP3 at 128 kbit/s is a good start) and your input device.
  4. Close the settings and press the play button.

Liquidsoap ​

Liquidsoap is the usual choice when you want playlists or a live DJ taking over from automation. It decides what plays; Quikcast delivers it.

ruby
radio = playlist("/music")

output.icecast(
  %mp3(bitrate=128),
  host="127.0.0.1",
  port=8000,
  user="source",
  password="REPLACE_WITH_YOUR_PASSWORD",
  mount="/radio.mp3",
  radio
)

FFmpeg ​

Good for testing, or for streaming a file on a loop:

sh
ffmpeg -re -stream_loop -1 -i music.mp3 -c:a copy \
  -content_type audio/mpeg -f mp3 \
  "icecast://source:[email protected]:8000/radio.mp3"

For other formats change the content type to the one in the supported formats table.

Updating the song title ​

MP3 and AAC listeners can see "now playing" text. Most encoders send it for you. You can also send it yourself with the source password:

sh
curl -u source:YOUR_PASSWORD \
  "http://127.0.0.1:8000/api/metadata?mount=/radio.mp3&mode=updinfo&song=Artist+-+Title"

Icecast-compatible software that sets titles itself (Liquidsoap's output.icecast, BUTT, Mixxx) sends the same request to /admin/metadata or the older /admin/metadata.xsl, with the source username and password. Quikcast accepts both on the streaming port. artist and title are combined as "artist - title" when song is missing.

If your software sends titles in a legacy character set, add &charset=ISO-8859-1 (or set charset on the mount, see configuration) and Quikcast converts it to UTF-8.

Ogg and FLAC streams carry titles inside the audio itself, so this call does not apply to them.

What if it does not connect? ​

An error such as 401, 403, 404, 409 or 415 has a known cause. See My encoder cannot connect.