---
name: "liquidsoap"
section: "1"
platform: "linux"
package: "liquidsoap"
version: "2.3.2-2+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/liquidsoap"
---

# liquidsoap(1)

a multimedia streaming language

## NAME

liquidsoap - a multimedia streaming language

## SYNOPSIS

liquidsoap \[ *options* \] \[ *script* \| *expression* \]

## DESCRIPTION

Liquidsoap is a programming language for describing multimedia streaming systems. It is very flexible, making simple things simple but giving a lot of control for advanced uses. Liquidsoap supports audio, video and MIDI streams, and a wide range of input/output operators including Icecast and various soundcard APIs. It can perform a broad range of signal processing, combine streams in various ways, support custom transitions, generate sound procedurally... and all this can be assembled as you wish. Input files can be accessed remotely, or even be synthesized on the fly using external scripts such as speech synthesis. Finally, interaction with a running liquidsoap instance is possible via telnet or socket.

Liquidsoap scripts passed on the command line will be evaluated: they shall be used to define the streaming system to be ran. It is possible to pass multiple scripts; they will all be ran successively, and definitions from one script can be used in subsequent ones. A script will be read from standard input if `-` is given as script filename. Information about scripting liquidsoap is available on our website: ⟨http://liquidsoap.info/⟩\\c .

If the parameter is not a file it will be treated as an expression which will be executed. It is a convenient way to test simple one-line scripts. When running only one-liners, the default is to log messages directly on stdout rather than to a file.

## OPTIONS

- \-

  Read script from standard input.

- \--

  Stop parsing the command-line and pass subsequent items to the script.

- \--debug

  Print debugging log messages.

- \--dynamic-plugins-dir *path*

  Directory where to look for plugins.

- \--errors-as-warnings

  Issue warnings instead of fatal errors for unused variables and ignored expressions. If you are not sure about it, it is better to not use it.

- \--interactive

  Start an interactive interpreter.

- \--list-plugins

  List all plugins (builtin scripting values, supported formats and protocols).

- \--list-plugins-xml

  List all plugins (builtin scripting values, supported formats and protocols), output as XML.

- \--no-stdlib

  Do not load pervasive script libraries.

- \--version

  Display Liquidsoap’s version.

- \--build-config

  Display Liquidsoap’s build config.

- \-c, --check

  Check and evaluate scripts but do not perform any streaming.

- \-cl, --check-lib

  Like --check but treats all scripts and expressions as libraries, so that unused toplevel variables are not reported.

- \-d, --daemon

  Run in daemon mode.

- \-f, --force-start

  For advanced dynamic uses: force liquidsoap to start even when no active source is initially defined.

- \-h *plugin*

  Print the description of a plugin, eg. a builtin scripting function.

- \-i

  Display inferred types.

- \-p, –parse-only

  Parse scripts but do not type-check and run them.

- \-q, --quiet

  Do not print log messages on standard output.

- \-r *filename*

  Process a request.

- \-T, --disable-telnet

  Disable the telnet server.

- \-U, --disable-unix-socket

  Disable the unix socket.

- \-t, --enable-telnet

  Enable the telnet server.

- \-u, --enable-unix-socket

  Enable the unix socket.

- \-v, --verbose

  Print log messages on standard output.

- \--list-settings

  Show all settings with their documentation.

\-help, --help Display this list of options

## SEE ALSO

Our website ⟨http://liquidsoap.info/⟩\\c  and the HTML documentation coming with your distribution of Liquidsoap.

## AUTHOR

The savonet team.