1. Design
     Streams    A functional language    Dynamic  

2. Applications

3. External links

4. References

Liquidsoap is an audio programming language developed initially to produce audio and video source streams sent to an Icecast server.^[1] The difference with other available tools is that Liquidsoap interprets a dedicated script language, which makes it very versatile and adaptable to a lot of various usages.

The recent releases of Liquidsoap also include the possibility to interact with the local sound card or to output multimedia data to local files using various formats. Thus, Liquidsoap is not only a source client for Icecast, but a general purpose specialized audio language dedicated to the automation of audio and video processing and streaming.

Liquidsoap is released under the GNU General Public License (GPL), is part of the Savonet project, and is developed in OCaml. The Savonet project also provides OCaml modules used for the various features supported by Liquidsoap.

Design

Describing an audio stream can be very complex: several inputs (files, stream relaying, sound card input) that can be combined in various ways (audio processing, mixing, track scheduling, fall-backs)^[1]{{rp|3}} and finally be output in various other ways (several servers, contents and formats). Liquidsoap uses its own scripting language for configuration.

Streams

In the Liquidsoap language, audio and video streams are represented by variables. However, a stream is an infinite object, hence streams variable in Liquidsoap cannot be directly manipulated. Instead, they are processed through operators that wrap operations around them.

Additionally, a stream is a high-order object{{clarification needed|date=April 2015}} that represents an infinite sequence of audio or video data samples but also metadata and breaks which represent tracks limits.

For example, a stream can be defined from an external audio stream the following way:

s = input.http("http://server.org:8000/stream")

Later, if the user wants to apply a volume change to this stream, he uses the amplify() operator:

s = amplify(2.0, s)

This code redefines the source s. The new source now has an amplification process applied to it, which will take the data from the original source, apply the amplification to it and pass it to the new source.

Eventually, the stream is passed to an output, which can be either a local output, to the sound card, a JACK server, a file, etc.., or an output to a distant server such as an Icecast server:

output.icecast.vorbis(host="server.org",mount="my_radio", s)

A functional language

The Liquidsoap language is a functional language. Hence, functions can be used as variables. In particular, since streams are infinite objects, the only way to apply an operation on every element

of the stream is to define a generic function that is applied to each element once it is generated.

For instance, you can define an operation on each metadata carried by the stream:

1. A function to apply to each metadata

def f(m) =

end

1. Redefine s and apply f
2. to every metadata

s = on_metadata(f, s)

Dynamic

When executing a script, Liquidsoap parses each operators and definitions. From these objects, it generates

an oriented graph of operators whose roots are the sources and leaves the outputs.

This graph is executed on the reverse order: for each output, Liquidsoap asks for a complete frame of data.

Then the output propagates this to the nodes below it, up to the roots of the graph where the source fills the frame.

During this execution, the same frame object is passed to each operators in the graph, allowing a minimal number of copies of the audio and video data, which is important to maintain a correct efficiency.

Applications

An Internet radio station can be implemented using Liquidsoap and icecast or Airtime^[4]. There has even been a suggestion Liquidsoap may be utilized on a Raspberry Pi to function as an STL codec encoder.^[5]

External links

• Liquidsoap website

References

• 1820 US Census
• 1820 US Law on Slave Trade
• 1820 U S Law on Slave Trade
• 1820 U.S. Law on Slave Trade
• 1820 U. S. Law on Slave Trade
• 1820 U.S. presidential election
• 1820–1829
• 1821-1923 War
• 1821 Aconcagua
• 1821 AHS
• 1821 in birding and ornithology
• 1821 in France
• 1821 in Norway
• 1821 in paleontology
• 1821 in sports
• 1821 in the United States
• 1821 United States House of Representatives elections in New York
• 1821 United States Senate election in New York
• 1821 Wallachian Revolution
• 18228 Hyperenor
• (182294) 2001 KU76
• 1822 AHS
• 1822 (book)
• 1822 Illinois gubernatorial election
• 1822 in birding and ornithology