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
| Setting | Value | Where it comes from |
|---|---|---|
| Server type | Icecast | Quikcast speaks the Icecast source protocol. |
| Host | Your server's address, for example 127.0.0.1 | The machine running Quikcast. |
| Port | 8000 | Your listen setting. |
| Mount or mountpoint | /radio.mp3 | The path of the mount. |
| Username | source | The mount's username (default source). |
| Password | The contents of the mount's secret file | secret_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.
- Open Settings → Main → Server → ADD.
- 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
- Name: anything, for example
- Under Audio, pick the codec (MP3 at 128 kbit/s is a good start) and your input device.
- 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.
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:
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:
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.