Skip to content

swesterfeld/liquidsfz

Repository files navigation

License Test Build Version

liquidsfz

DESCRIPTION

liquidsfz is a free and open source sampler that can load and play .sfz files. It can also load and play Hydrogen drumkits. We support JACK and LV2.

The main goal is to provide a library that is easy to integrate into other projects.

The API should be fairly stable at this point, so we try to maintain source compatibility.

COMPILING

To compile liquidsfz, use the usual

./configure
make
make install

You need the packages (on Debian/Ubuntu):

  • libjack-jackd2-dev (JACK client)
  • libreadline-dev (JACK client)
  • lv2-dev (LV2 plugin)
  • libsndfile1-dev

Some components can be disabled during configure, --without-jack will turn off building the JACK client, --without-lv2 will turn off building the LV2 plugin.

If you are building from git, you also need the package (for autogen.sh to work):

  • autoconf-archive

USING JACK

The liquidsfz command line program can be used like this:

liquidsfz ~/sfz/SalamanderGrandPianoV3_44.1khz16bit/SalamanderGrandPianoV3.sfz

Or if you want to load a Hydrogen drumkit, like this:

liquidsfz /usr/share/hydrogen/data/drumkits/GMRockKit/drumkit.xml

liquidsfz works as a JACK client with midi input and audio ouput. If you connect the JACK midi input / audio output using a patchbay, you can send midi events to liquidsfz to test the sfz loader.

If you are interested in using a graphical front-end in conjunction with JACK, you can try QLiquidSFZ.

LV2 PLUGIN

We provide an LV2 plugin, for hosts like Ardour/Carla/Qtractor and others, which is built and installed by default. It can also be downloaded as binary release below.

LICENSE

The code is licensed under MPL-2.0.

RELEASES

The current version of liquidsfz is liquidsfz-0.3.2, and can be downloaded here:

BINARY LV2 PLUGIN

The LV2 plugin (and only the LV2 plugin) is available as self-contained 64-bit binary.

LINUX BINARY

The Linux version is available here:

To install it, extract the archive and

mkdir -p $HOME/.lv2
cp -a liquidsfz.lv2  $HOME/.lv2/

WINDOWS BINARY

The Windows plugin is available here:

To install it, extract the zip file to the location where your LV2 plugins are, usually

C:\Program Files\Common Files\LV2

WINDOWS DLL

If you are a Windows developer and need only the .dll (not the plugin or JACK client), there is experimental support for building on Windows but this is experimental and may or may not work.