LinuxSampler

blank
news about features screenshots demos download developers faq documentation bugs instruments links credits

FAQ

Here is a collection of frequently asked questions. Please read them before asking on the mailing list.

  1. Can I use LinuxSampler in commercial hardware or software products?
  2. Can I use LinuxSampler for commercial music production?
  3. LinuxSampler is not open source, you are evil!
  4. linuxsampler? qsampler? jsampler? libgig? liblscp? jlscp? ... hu?
  5. What do I need to compile and install?
  6. Compilation of LinuxSampler aborts with ...
  7. How do I checkout from CVS?
  8. How do I compile from CVS?
  9. Can I use linuxsampler without a GUI as well?
  10. Are there example LSCP script files somewhere?
  11. I get dropouts (click sounds, noise), what can I do about it?

Can I use LinuxSampler in commercial hardware or software products?

You are NOT ALLOWED to use LinuxSampler source code, libraries or applications in COMMERCIAL hardware or software products without prior written authorization by the authors. See here

Can I use LinuxSampler for commercial music production?

Hell, yes! Every indirect commercial usage of LinuxSampler, which essentially means using its audio output, can of course be used in commercial applications like music productions, live shows, etc. Don't get us wrong, with the mentioned commercial exception we don't want to restrict the normal user / musician, we just want to avoid somebody to directly make money with our work, that is by selling our software in a sampler product like a sampler + sample library bundle, a hardware sampler or something equivalent, at least not without giving something back to the open source Community.

LinuxSampler is not open source, you are evil!

There are of course many definitions of the term "open source", but according to the definition on Wikipedia LinuxSampler is in fact open source, since you've got complete access to its source code. So due to this fact, a normal user / musician is free to do with LinuxSampler what he likes to do, he can even adjust and tweak every single part of the software by modifying and compiling its source code. And just the fact that we want to avoid our work to be directly exploited in commercial software or hardware products is definitely not an "evil" intention. For the normal user / musician the commercial restriction is even an advantage, since that way commercial actors are forced to support this or another open source project either directly by coding or indirectly by funding and thus increase development speed.

linuxsampler? qsampler? jsampler? gigedit? libgig? liblscp? jlscp? ... hu?

There are currently seven subprojects in the LinuxSampler project; jlscp, jsampler, libgig, liblscp, linuxsampler, gigedit and qsampler. linuxsampler is the core of the sampler, it includes the sampler engines and audio and MIDI drivers. linuxsampler itself is decoupled from any user interface. It offers a native C++ API as well as a network server (LSCP server) to allow to be controlled by an arbitrary user frontend from an arbitrary place over a network connection or (of course) locally from the same machine as well. This decoupled / "backend" design of the sampler allows to run it even on a machine without any graphical interface, without a Desktop, the machine doesn't even have to have a graphics card! qsampler is the first GUI frontend written for linuxsampler, it is written in C++ using the Qt GUI library and thus can be compiled for various architectures and operating systems without modifications of the source code. gigedit is an instruments editor application for Gigasampler format files. You can run it as stand-alone application or in conjunction with LinuxSampler. In the latter case you can play and immediately hear all your modifications made with gigedit in realtime. libgig is a C++ library written for accessing Gigasampler files and DLS Level 1 and 2 files, that is for reading and (since version 3.0.0) also writing of those files. libgig is used by linuxsampler to load Gigasampler files, it is used by gigedit to load, modify and create new Gigasampler files and it can be used by qsampler to retrieve additional informations about Gigasampler files. liblscp is a C library written as a wrapper around the LSCP network protocol, thus to control linuxsampler. It was originally designed to be used on both sides, that is on server / backend side (linuxsampler) and on client / frontend side (e.g. qsampler). But it's now only used on client side by qsampler at the moment. jsampler is another GUI frontend for linuxsampler, it's written in Java and thus platform independent. jlscp is a library which can be compared with liblscp, with the only difference that jlscp is written in Java and liblscp in C. jsampler requires jlscp.

What do I need to compile and install?

You should compile and install at least libgig and linuxsampler. As a beginner you should definitely as well compile and install a convenient GUI frontend like either qsampler or jsampler, whatever you prefer. qsampler depends on liblscp, so you have to compile and install liblscp before starting to build qsampler. Also if you like to be able to edit instruments, you should compile and install gigedit as well. The recommended order to compile and install is:

  1. libgig
  2. linuxsampler
  3. gigedit
  4. liblscp
  5. qsampler

Of course you can also install QSampler and JSampler side by side. So you can test and use both at the same time.

Compilation of LinuxSampler aborts with ...

•   "Required libgig version not found..."

This error might occur when running LinuxSampler's configure script. Make sure you have the required libgig version installed. If you're compiling a CVS version of LinuxSampler you usually have to compile and install the current CVS version of libgig as well. Also note there are couple common mistakes which let this error occur even after having compiled and installed the required libgig version. Read this bug report about common mistakes and how you can fix them.

•   "can't find a register in class `GENERAL_REGS' while reloading `asm'"

This is caused by the inline assembly code for SIMD optimization in older versions of linuxsampler. You have to compile older versions of LinuxSampler (v0.3.3 and older) with -O2 or -O3 to avoid this problem. Usually this is done by default, if not try:

CXXFLAGS="-O3" ./configure
make

Alternatively you could also disable all hand-crafted assembly optimization code by:

./configure --disable-asm
make

but the latter is definitely not recommended, as it will increase CPU usage a lot!

•   "../common/Resampler.h:142: error: memory input 2 is not directly addressable"

This was reported (1, 2) to be a gcc/g++ version problem, in conjunction with the inline assembly code for SIMD optimization in older versions of linuxsampler. Make sure you got gcc and g++, both of version 3.3 or higher installed. You can check this with:

gcc --version
g++ --version

In case you already got gcc and g++ of version 3.3 or higher installed and it still causes the compilation error mentioned above, try the following:

export CC=`which gcc`
export CXX=`which g++`

On certain systems however you still get this error in conjunction with older versions of LinuxSampler (v0.3.3 and older). Fortunately newer versions of linuxsampler are not affected anymore (read this for details).

How do I checkout from CVS?

The procedure of checking out the newest version from CVS is described on the Downloads site and on the web interface site of our CVS server.

How do I compile from CVS?

The procedure for compiling from CVS is the same for all subprojects, that is no matter if you are compiling linuxsampler, qsampler, libgig or liblscp from CVS, you need to have the autotools (automake, autoconf and libtool) installed and compile it that way:

make -f Makefile.cvs
./configure
make

Can I use linuxsampler without a GUI as well?

Yes, but unfortunately there is no console based frontend for linuxsampler (yet). You have to write LSCP scripts and send it to the running linuxsampler application. But don't worry, if you don't know how to write LSCP scripts, you can also start by saving a sampler session with QSampler, because the session files qsampler writes are actually real LSCP scripts. You can send a LSCP script to linuxsampler on the console with the following command:

netcat localhost 8888 < yourscript.lscp

or on certain systems (like Debian) you have to provide the -t switch:

netcat -t localhost 8888 < yourscript.lscp

Of course you can also replace localhost by the IP address of the machine where linuxsampler is running. Alternatively you can also make a telnet connection (port 8888) to linuxsampler's LSCP server and type commands manually.

Are there example LSCP script files somewhere?

Yes, have a look on the Documentation site for some common LSCP script examples. For details about LSCP read the LSCP reference. Be welcome to ask questions for details about LSCP on the mailing list.

I get dropouts (click sounds, noise), what can I do about it?

In order to achieve good results under Linux you need to have a patched kernel. There are different patches available depending on what version (2.4.x or 2.6.x) of kernel you use. The JACK FAQ site (or the old JACK FAQ site) is also a good resource for how to configure a realtime stable kernel. But note; LinuxSampler currently has not support for libcap yet, that means if you are still using a 2.4.x Linux kernel you most probably have to run LinuxSampler with root priviliges. As a rule of thumb: if you don't get warnings like "cannot mlockall() memory" on the console, you are safe to run it as ordinary user as well.