Skip to content

Liquidsoap is a statically typed scripting general-purpose language with dedicated operators and backend for all thing media, streaming, file generation, automation, HTTP backend and more.

License

Notifications You must be signed in to change notification settings

savonet/liquidsoap

Folders and files

NameName
Last commit message
Last commit date
Jan 24, 2025
Jan 5, 2025
Nov 30, 2024
Jan 24, 2025
Jan 22, 2025
Jun 19, 2023
Jul 28, 2019
Nov 2, 2023
Mar 8, 2023
Dec 12, 2024
Jun 23, 2019
Jan 24, 2025
Nov 16, 2023
Feb 23, 2024
May 30, 2022
Jan 11, 2016
Nov 27, 2024
Jul 21, 2023
Sep 21, 2024
Jul 3, 2024
Jun 13, 2024
Jan 22, 2025
Jun 13, 2024
Jan 22, 2025
Dec 4, 2024
Dec 15, 2024
Dec 4, 2024
Dec 4, 2024
Dec 4, 2024
Sep 28, 2022
Dec 4, 2024
Jul 21, 2024
Jun 18, 2023
Jun 18, 2023
Oct 21, 2024

Repository files navigation

Liquidsoap

Liquidsoap is a swiss-army knife for multimedia streaming, notably used for netradios and webtvs. It has tons of features, it's free and it's open-source!

Liquidsoap is a powerful and flexible language for describing your streams. It offers a rich collection of operators that you can combine to create and transform streams. Liquidsoap is very light and easy to use, in the Unix tradition of simple strong components working together.

Copyright 2003-2024 Savonet team

GPL license CI GitHub release Install with Opam! Chat on Discord!

Built with Depot

Homepage http://liquidsoap.info
Discord Chat http://chat.liquidsoap.info
Blog https://www.liquidsoap.info/blog/
Bug reports https://github.com/savonet/liquidsoap/issues
User questions https://github.com/savonet/liquidsoap/discussions
IRC (deprecated) #savonet on irc.libera.chat (w/ discord bridge)
Mailing list (deprecated) savonet-users@lists.sourceforge.net

Installation

See the instructions here.

Release Details

Current release status by version:

Branch Latest release Supported Rolling Release
2.3.x 2.3.0 (docker: savonet/liquidsoap:v2.3.0) 2.3.x (docker: savonet/liquidsoap:rolling-release-v2.3.x
2.2.x 2.2.5 (docker: savonet/liquidsoap:v2.2.5) 2.2.x (docker: savonet/liquidsoap:rolling-release-v2.2.x
2.1.x 2.1.4 (docker: savonet/liquidsoap:v2.1.4) 2.1.x (docker: savonet/liquidsoap:rolling-release-v2.1.x

Versions

Liquidsoap releases follow a semantic versioning as follows:

<major_version>.<minor_version>.<bugfix_version>

Where:

  • major_version is bumped when there are major changes, i.e. changes in the paradigm, major implementation change etc. Versions with different major versions are incompatible
  • minor_version is bumped when there are minor changes, i.e. new operators, renaming, new modules etc. Version with different minor versions may be incompatible
  • bugfix_version is bumped when a new bugfix version is published. Versions with only bugfix version changes should be compatible

Please note that liquidsoap is a complex framework with a lot of operators and advanced implementations. For this reason, it is possible that a bugfix actually fixes the behavior of an operator the way it was intended to be and may break scripts that previously relied on incorrect implementations.

Therefore, we strongly recommend maintaining a staging environment that makes it possible to test new versions before using them in production. In this context, the semantic versioning above should guide you in knowing how much scrutiny you should put into a new release before validating it in your staging environment.

Assets

Release assets are provided at: https://github.com/savonet/liquidsoap/releases. Published, versioned releases are available using their published tag, i.e. vx.y.z.

We also provide rolling releases. A rolling release is a snapshot of a current, unpublished release. It can be a future stable release or a future bugfix release for a given major/minor version.

For both types of releases, we reserve the right to update, delete and add assets to the release at any time. If you are looking for permanent links to release assets, you should grab them from https://github.com/savonet/liquidsoap-release-assets/releases, which reflects all our releases but whose artifacts are never modified/deleted.

Tooling

Formatting liquidsoap-prettier
VSCode vscode-liquidsoap
Tree Sitter tree-sitter-liquidsoap, nvim-treesitter
CodeMirror codemirror-lang-liquidsoap
Playground https://www.liquidsoap.info/try/

Documentation

HTML documentation is available on our website

We also have written the Liquidsoap book which is available online and in physical version.

Contributing

Contributions are more than welcome: you can submit issues if you find some, or contribute to the code through pull requests. You can checkout the code with

git checkout git@github.com:savonet/liquidsoap.git

Please see our documentation page about how to build the code.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details, fully stated in the COPYING file at the root of the liquidsoap distribution.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Authors

  • Developers:
  • Former project leader and emeritus developer:
  • Contributors:
    • Florent Bouchez
    • Julien Cristau
    • Stéphane Gimenez
    • Clément Renard
    • Vincent Tabard
    • Sattisvar Tandabany

About

Liquidsoap is a statically typed scripting general-purpose language with dedicated operators and backend for all thing media, streaming, file generation, automation, HTTP backend and more.

Topics

Resources

License

Security policy

Citation

Stars

Watchers

Forks

Sponsor this project