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.fm/

       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-pervasives
              Do not load pervasive script libraries.

       --version
              Display liquidsoap's version.

       -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.

       --conf-descr-key key
              Describe a configuration key.

       --conf-descr
              Show all configuration keys with their documentation.

       --conf-descr-liqi
              Show  all  configuration keys with their documentation in liqi (documentation wiki)
              format.

       --conf-dump
              Dump the configuration state

       -help, --help
              Display this list of options

SEE ALSO

       Our  website  http://www.liquidsoap.fm/  and  the  HTML  documentation  coming  with  your
       distribution of liquidsoap.

AUTHOR

       Savonet team <savonet-users@lists.sourceforge.net>