Documentation index

How to use: Start with the quickstart and make sure you learn how to find help. Then it’s as you like: go for another general tutorial, or a specific example, pick a basic notion, or some examples from the cookbook. If you’ve understood all you need, just browse the reference and compose your dream stream.

If you downloaded a source tarball of liquidsoap, you may first read the build instructions.

If you are migrating from a previous version, you might want to checkout this page.

General tutorials

Blank detection
Customize metadata
Dynamic source creation: dynamically create sources using server requests.
External decoders: use an external program for decoding audio files.
External encoders: use an external audio encoding program.
External streams: use an external program for streaming audio data.
HLS output: output your stream as HTTP Live Stream.
HTTP input: relay external streams.
Harbor input: receive streams from icecast and shoutcast source clients.
ICY metadata update: manipulate and configure metadata update in Icecast.
Interaction with the Harbor: interact with a running Liquidsoap using the Harbor server.
Interaction with the server interact with a running Liquidsoap instance using the telnet server.
Normalization and replay gain: normalize audio data.
Profiling: profiling your scripts.
Prometheus reporting: metrics reporting via prometheus.
Requests-based sources: create advanced sources using requests.
Seek and cue support: seek and set cue-in and cue-out points in sources.
Shoutcast output: output to shoutcast.
Smart crossfading: define custom crossfade transitions.
Using in production: integrate liquidsoap scripts in a production environment.