Jump to content

LV2

From Wikipedia, the free encyclopedia
LV2
Developer(s)Steve Harris, David Robillard, other members of linux-audio-dev
Stable release
1.18.10[1] Edit this on Wikidata / 9 September 2022; 2 years ago (9 September 2022)
Repositorygitlab.com/lv2/lv2
Written inC and Turtle
LicenseISC License
Websitelv2plug.in

LV2 (LADSPA Version 2) is a set of royalty-free open standards[2] for music production plug-ins and matching host applications. It includes support for the synthesis and processing of digital audio and CV,[3] events such as MIDI and OSC, and provides a free alternative to audio plug-in standards such as Virtual Studio Technology (VST) and Audio Units (AU).

LV2 succeeds the more limited Linux Audio Developer's Simple Plugin API (LADSPA) standard and replaces the Disposable Soft Synth Interface (DSSI) plugin infrastructure ("LADSPA for instruments"), adding abilities such as MIDI capability, custom UIs, and a system allowing extensibility of the initial standard.[4][5]

LV2 plugin listing in the Carla host

Over twelve hundred plugins are now available in LV2 format.[6] Notable plugins include Calf Studio Gear.[7] Software that can host LV2 plugin "bundles" includes Ardour, Ingen, Carla (of KXStudio), Qtractor, Traverso DAW,[8] Harrison Mixbus,[9] MusE, Audacity,[10] Ecasound, FFmpeg, Guitarix, the GStreamer framework and DJing software Mixxx, with currently partial support in LMMS and REAPER. It is also the plugin format used by the MOD Duo and MOD Duo X, [11] Zynthian, and Poly Effects Digit/Beebo hardware units.

Concepts

[edit]

LV2 is an extensible framework, allowing a program to load a plugin to do some processing. Note that the terms used here are generic on purpose because LV2 allows any type of data to be exchanged between the host and the plugin.

LV2 plugins in the Ingen host
LV2 modular drum synth in Carla

RDF

[edit]

The LV2 specifications are defined by[12] and make use[13] of RDF metadata in Turtle format. Technologies involved include Dublin Core, FOAF, DOAP, SPDX, XSD, RDFS and OWL.[14] The relational capabilities and properties this syntax supports are powerful but can be hard to understand at first.[15]

Beyond the core specification there are 21 official extensions providing support for host options, plugin presets, time and units, port buffers, properties, groups and parameter labels, for sending MIDI, patches, UI events and more.[16] There are various third-party extensions for supporting expressive events, OSC, and MOD Devices specific hardware and software, with three in the KXStudio LV2 Namespace.

The plugin uses this information to provide a list of capabilities to the host, so the host can accommodate those.[17] Similarly, the host can provide a list of LV2 extension capabilities that it supports on initialization of the plugin.

In the example below, first the shortcut prefixes for the lv2, doap and spdx ontology are declared. Next, every plugin must have its own URI or URN. Then the 4 following declare that this resource is an lv2:Plugin, a binary object file library with the filename silence.so should be present, the plugin is known under the name Silence, and is licensed under the GNU GPL. These 4 properties are mandatory for an LV2 plugin; if a plugin does not have all of them a host might not load it.

@prefix lv2:  <http://lv2plug.in/ns/lv2core#>.
@prefix doap: <http://usefulinc.com/ns/doap#>.
@prefix spdx: <http://spdx.org/rdf/terms#>.

<http://example.org/lv2/wikipediaexample/silence>
  a lv2:Plugin;
  lv2:binary <silence.so>;
  doap:name "Silence";
  doap:license spdx:GPL-3.0-or-later;
  rdfs:comment "This is an example plugin that includes an example plugin description."

  lv2:port [
    a lv2:AudioPort, lv2:OutputPort;
    lv2:index 0;
    lv2:symbol "output";
    lv2:name "Output";
  ].

Atoms

[edit]

"Atom" data structures are used for messaging between plugin ports[18][19] for the transfer of MIDI,[20] OSC, Patch,[21] UI and other events between plugin instances. These can also be serialised on Turtle.[22][23]

UI

[edit]
Host interface to plugin properties

Aside from separating metadata from binaries, LV2 mandates a general separation between DSP and user interface processing. Benefits include that UI processing cannot hold back DSP processing, and UI and DSP can be separated across a network. Messaging using Atoms is the preferred method for passing updates between the running DSP and UI binaries.

Hosts can also provide an interface for displaying and configuring the properties of plugin instances. There are extensions and properties to help display the correct control types.

Threading

[edit]

One capability that a host can provide to a plugin is a "worker thread". In programming terms, this means that the plugin can offload some work to be done in another thread that the host provides. This is generally useful because a plugin is usually run in the real-time audio thread of an application, and hence cannot do any non-real-time safe operations (disk-accesses, system calls, etc.). To make it easy for the plugin to achieve its goals (e.g.: load a file from disk), the host can provide a worker thread. The host provides the LV2_Extension for the worker thread[24] and the plugin is then able to use it.

Development

[edit]

There are tools and frameworks available to assist with in creating LV2 plugins. These include DPF (DISTRHO Plugin Framework), JUCE, Faust, Dplug, iPlug 2 (alpha), and Cabbage (alpha). There is also the ability to load Pure Data patches as well as JIT-run Faust, Rust, Lua or C code in certain LV2 plugins.

See also

[edit]

References

[edit]
  1. ^ "LV2 1.18.10".
  2. ^ "LV2 / Lv2".
  3. ^ JACK/LV2 CV - LinuxMusicians
  4. ^ List of LV2 features
  5. ^ drobilla.net : LV2: The good, bad, and ugly
  6. ^ List of 1000+ plugin uris [1] site.
  7. ^ "Calf Studio Gear supports LV2".
  8. ^ "Traverso User Manual, p. 26" (PDF). Archived from the original (PDF) on 2016-04-23. Retrieved 2020-02-21.
  9. ^ Harrison Website
  10. ^ Audacity Archived 2008-09-29 at the Wayback Machine
  11. ^ "MOD Devices". moddevices.com. Retrieved 2016-04-16.
  12. ^ "Lv2/Core/Lv2core.TTL · master · LV2 / Lv2".
  13. ^ "Lv2/Core/Lv2.h · master · LV2 / Lv2".
  14. ^ "Lv2/Schemas.lv2 at master · lv2/Lv2". GitHub.
  15. ^ drobilla.net : Writing an LV2 Book
  16. ^ "LV2 Specifications".
  17. ^ Programming LV2 Plugins book with example plugins.
  18. ^ LV2 Atoms: A Data Model for Real-Time Audio Plugins (PDF)
  19. ^ "LV2 Atom".
  20. ^ "LV2 MIDI".
  21. ^ "LV2 Patch".
  22. ^ drobilla.net : LV2 atom and state serialisation -
  23. ^ https://github.com/lv2/sratom - a small C library for serialising LV2 atoms to and from RDF, for converting between binary and text or storing in a model.
  24. ^ "LV2 Worker".
[edit]