LIQUIDSOAP(1)

📦
version 2.4.2 · 7 versions
, in ubuntu stonking

💖 LIQUIDSOAP 💖

okay bestie, welcome to liquidsoap — the manual page, but make it cute. it's a multimedia streaming language and it's honestly iconic. let's get into it 🎀

✨ NAME ✨

liquidsoap — a multimedia streaming language 🎧📡

🌸 SYNOPSIS 🌸

liquidsoap [ options ] [ script | expression ]

💅 DESCRIPTION 💅

So. liquidsoap is a programming language for describing multimedia streaming systems. it's super flexible — like, simple things stay simple but you get SO much control if you're doing advanced stuff. it supports audio, video and MIDI streams, plus a whole range of input/output operators including Icecast and various soundcard APIs. it can do a broad range of signal processing, combine streams in all kinds of ways, support custom transitions, generate sound procedurally… and babe, all of it can be assembled however you want. no cap. 🔥

input files can be accessed remotely, or even synthesized on the fly using external scripts like speech synthesis. and finally, you can interact with a running liquidsoap instance via telnet or socket. main character energy tbh. 👑

Scripts passed on the command line get evaluated — they're what defines the streaming system you're gonna run. you can pass multiple scripts too! they all run successively, and definitions from one script can be used in subsequent ones. if you give - as the script filename, a script gets read from standard input. info about scripting liquidsoap lives on the website: http://liquidsoap.info/. 🦋

If the parameter isn't a file, it gets treated as an expression that will be executed. it's a convenient way to test simple one-line scripts. and when you're running only one-liners, the default is to log messages directly on stdout rather than to a file. cute, right? ✨

🌈 OPTIONS 🌈

  • - — read the script from standard input 📥
  • -- — stop parsing the command-line and pass the subsequent items to the script ✋
  • --build-config — display liquidsoap's build configuration 🛠️
  • --cache-only — parse, type-check and save the script's cache, but do not run it 💾
  • --cache-stdlib — generate the standard library cache 📚
  • --debug — print debugging log messages 🐛
  • --debug-errors — debug errors (show a stacktrace instead of printing a message) 💀
  • --debug-lang — debug the language implementation 🔍
  • --debug-levels — debug typing levels 📶
  • --debug-subtyping — debug subtyping 🧬
  • --disable-deprecated — do not load wrappers for deprecated operators 🚫
  • --enable-deprecated — load wrappers for deprecated operators ✅
  • --interactive — start an interactive interpreter 💬
  • --list-deprecated-functions-md — documentation of all deprecated functions in markdown 📝
  • --list-extra-functions-md — documentation of all extra functions in markdown 📝
  • --list-functions — list all functions 📋
  • --list-functions-by-category — list all functions, sorted by category 🗂️
  • --list-functions-json — documentation of all functions in JSON format 🧾
  • --list-functions-md — documentation of all functions in markdown format 📄
  • --list-plugins — list all plugins (builtin scripting values, supported formats and protocols) 🔌
  • --list-portaudio-devices — list all available portaudio devices 🎛️
  • --list-protocols-md — documentation of all protocols in markdown 📑
  • --list-settings — display configuration keys in markdown format ⚙️
  • --no-cache — disable cache 🚫💾
  • --no-deprecated — deprecated: use --disable-deprecated ⚠️
  • --no-external-plugins — disable external plugins 🔌🚫
  • --no-fallible-check — ignore fallible sources 🙈
  • --no-stdlib — do not load stdlib script libraries 📚🚫
  • --opam-config — print out opam's liquidsoap.config, for internal use 🧰
  • --print-json-term — parse and output the script as normalized JSON. the JSON format is used internally to format code 🧾
  • --profile — profile execution ⏱️
  • --raw-errors — in normal executions, exceptions raised during the script are translated into user-friendly errors. use this option to let the original error surface. this is useful when debugging 🔥🐛
  • --safe — disable the effects of --unsafe 🛡️
  • --stdlib — override the location of the standard library 📚📍
  • --strict — execute script code in strict mode, issuing fatal errors instead of warnings in some cases. currently: unused variables and ignored expressions 😤
  • --unsafe — faster startup using unsafe features ⚡
  • --version — display liquidsoap's version 🏷️
  • -T, --disable-telnet — disable the telnet server 📵
  • -U, --disable-unix-socket — disable the unix socket 📵
  • -c, --check — parse, type-check but do not evaluate the script ✅
  • -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 — get help about a scripting value: source, operator, builtin or library function, etc. 🆘
  • -i — display inferred types 🏷️
  • -p, --parse-only — parse script but do not type-check and run them 📖
  • -q, --quiet — do not print log messages on standard output 🤫
  • -r, --request — process a file request and print the metadata 🗂️
  • -t, --enable-telnet — enable the telnet server 📞
  • -u, --enable-unix-socket — enable the unix socket 🔌
  • -v, --verbose — print log messages on standard output 🗣️
  • -help — display this list of options 📜
  • --help — display this list of options 📜

🫶 SEE ALSO 🫶

Our website http://liquidsoap.info/ and the HTML documentation that comes with your distribution of liquidsoap. go read it, it's giving homework but in a fun way 💖

👑 AUTHOR 👑

The savonet team. 🫡

and that's the whole vibe, bestie ✨ this was Liquidsoap @version@, dated Jul 24, 2019 — take care of her, she's iconic 💅🎀🌈

📦 where this page comes from