Linuxsampler is a software audio sampler.It can be loaded with libraries in the gigasampler format (.gig).

+

Linuxsampler is a software [http://en.wikipedia.org/wiki/Sampler_%28musical_instrument%29 audio sampler].It can be loaded with sound libraries in the gigasampler format (.gig).

−

One benefit of LS is it can stream samples from hard disk, allowing the usage of huge libraries (several GBs..).

+

One benefit of LS is it can stream the samples directly from hard disk, allowing the usage of huge libraries (several GBs..).LS can be started as a standalone application or lv2 or dssi plugin.Currently only the cvs build will provide those plugin versions.

−

By now, "Linuxsampler" refers to a group of softwares interacting together :

+

By now, "Linuxsampler" refers to a group of software interacting together :

All packages are available from the [[Arch User Repository|AUR]].You have choice between release or cvs versions.

+

If you choose the release versions then the most simple way is installing a frontend via yaourt, which will cascade all necessary dependencies in the right order :

+

$ yaourt -S qsampler

+

This should build and install in this order : libgig, linuxsampler, liblscp and finally qsampler.

+

You could install jsampler instead of qsampler if you prefer this interface, or install it later. It's perfectly ok to have multiple frontends for LS in the system.

+

+

If you need the gig file editor :

+

$ yaourt -S gigedit

+

You can now run qsampler which will automatically start linuxsampler. If you use jsampler, you have to start linuxsampler first.

+

+

==The (not so) long way==

+

+

===Installation===

'''IMPORTANT NOTE 1''' : Follow the installation order of theses components to get a working set of apps.

'''IMPORTANT NOTE 1''' : Follow the installation order of theses components to get a working set of apps.

+

All packages are available from the [[Arch User Repository|AUR]]. You have choice between release or cvs versions.

−

'''IMPORTANT NOTE 2''' : All packages are available from [[AUR]].The whole set can be grabbed as standard packages or cvs versions.

+

You should choose between a full set of standard packages OR CVS packages but '''do not mix them'''.

−

Standard packages in AUR are up-to-date but the sources tarballs released by the LS team can be old.

−

CVS versions are bleeding edge.They appear to work well in i686 and x86_64 architectures but it's never sure that all packages will build against each other at any time.

−

−

You should choose between a full set of standart packages OR cvs packages but '''do not mix them'''.

Whatever you choose, but particularly with cvs packages, you should keep in a safe place a set of binary packages that work together.

Whatever you choose, but particularly with cvs packages, you should keep in a safe place a set of binary packages that work together.

−

=== The backend : Linuxsampler ===

+

==== The backend : Linuxsampler ====

−

It is the "engine" of the sampler, which performs all the heavy and time critical computational tasks of handling MIDI events, calculating the audio data and sending the final audio data to your sound card(s).LinuxSampler itself usually runs as own process in the background of the computer and usually does not show up anything on the screen, or at most it can be launched to show status informations and debug messages in a console window.Usually you will also need a frontend to control it.

+

It is the "engine" of the sampler, which performs all the heavy and time critical computational tasks of handling MIDI events, calculating the audio data and sending the final audio data to your sound card(s). LinuxSampler itself usually runs as own process in the background of the computer and usually does not show up anything on the screen, or at most it can be launched to show status information and debug messages in a console window. Usually you will also need a frontend to control it.

Gigedit allows you to edit and create instruments for the Gigasampler format, which can be used with LinuxSampler as well as with Tascam's Gigastudio. You can use gigedit as stand-alone application without Linuxsampler running or in live-mode, started from any frontend ("edit" button).In this case, all your modifications are audible in realtime.

+

+

* Build and install (optional, you can skip this step if you do not need the editor): {{AUR|gigedit-svn}} '''or''' {{AUR|gigedit-cvs}}

and check that everything is ok :

and check that everything is ok :

−

$ linuxsampler

+

$ gigedit

+

+

The editor should pop-up in "stand-alone" mode as indicated in the down-right corner.

+

Close the window.

+

+

==== The frontend : Qsampler ====

+

This frontend provides the user a set of menus, buttons, sliders, dials, etc. to allow the user to control the sampler in a convenient way. It does not perform any signal processing tasks, so you can see it as a "face" of the sampler. From Qsampler you can load/unload .gig files into Linuxsampler and set their midi channel number, volume, jack output etc...and finally store all this setup in a file for a speedy re-opening of your "sampling orchestra".

−

then '''CTRL-c''' to quit.

+

* Build and install : {{AUR|liblscp}} '''or''' {{AUR|liblscp-cvs}}

−

=== The editor : Gigedit ===

+

* Build and install : {{AUR|qsampler}} '''or''' {{AUR|qsampler-svn}}

−

Gigedit allows you to edit and create instruments for the Gigasampler format, which can be used with LinuxSampler as well as with Tascam's Gigastudio.You can use gigedit as stand-alone application without Linuxsampler running or in live-mode, started from any frontend ("edit" button).In this case, all your modifications are audible in realtime.

−

Build and install :

+

===Building a default template in qsampler===

+

Here, I will use {{AUR|jack-keyboard}} as a MIDI controller, but everything below applies as well with a master keyboard or MIDI interface providing midi output.

:On the left panel, click on "Audio Devices".Now we can see the audio drivers available in the right panel.

+

:Choose "Jack" in the Driver menu.The default config should give you a pair of audio outputs at a sample rate of 44100.

+

:Click on the Create button down the window.

−

* [http://aur.archlinux.org/packages.php?ID=28073 gigedit-cvs]

+

'''Note :''' In some systems, qsampler crashes if this window is closed or even backgrounded while the Bottom-Right panel is still in view.Easy workaround : click on "Audio devices" or "Midi Devices" on the left panel before leaving or unfocusing the window.

−

and check that everything is ok :

+

* If you want LS to auto-connect to jack system outputs when you launch your template :

−

$ gigedit

+

:On the left panel, click on "Audio Jack Device 0" , then on right panel select "Audio Jack 0" from the "Channel" drop-down list.

+

:Choose an output for the JACK_BINDINGS parameter, like "system:playback 1".

The editor should pop-up in "stand-alone" mode as indicated in the down-right corner.

+

* Now let's create a midi input also :

−

Close the window.

+

:On the left panel, click on "Midi Devices".

+

:On the right panel, choose "jack" (jack-midi) in the Driver menu.

+

:Hit the create button.

−

=== The frontend : Qsampler ===

+

* If you want LS to auto-connect to jack-keyboard midi output when you launch your template :

−

This frontend provides the user a set of menus, buttons, sliders, dials, etc. to allow the user to control the sampler in a convenient way.It does not perform any signal processing tasks, so you can see it as a "face" of the sampler.From Qsampler you can load/unload .gig files into

+

:Select the "Midi jack device" port 0" on the left panel.

−

Linuxsampler and set their midi channel number, volume, jack output etc...and finally store all this setup in a file for a speedy re-opening of your "sampling orchestra".

+

:On the right panel, for the "JACK_BINDINGS" parameter value, choose "jack-keyboard:midi out".

−

Build and install :

+

Note that if jack-midi is not enabled in Qjackctl, you won't find the midi client in the drop-down list.You can check in Qjackctl setup : "Midi driver" should be set to "seq".A restart of jack and qsampler is needed.

−

* [http://aur.archlinux.org/packages.php?ID=11081 gigedit]

+

Also, if jack-keyboard or whatever midi controller you defined in here is not started before qsampler starts, you will likely receive an error from qsampler not finding the midi client.In that case, you can still start the midi device and connect it to LS through qjackctl.

−

or

+

* Finally close the Devices Config window and save your template.

+

{{Tip|You can define as much midi ports as midi controllers you use. The same applies to audio outputs, e.g for sending separated instrument outputs for recording in Ardour.}}

−

* [http://aur.archlinux.org/packages.php?ID=28073 gigedit-cvs]

+

===Building a performance template in qsampler===

+

* Open qsampler and load your configuration template.

+

* Press the "Add channel" button in the toolbar (Ctrl-A).A "channel" in the LS terminology is an object (visually a strip) which stores the settings for a given instrument : Name and location of the gig file, inputs & outputs used, midi channel, volume, solo/mute status, midi cc applied etc..much like a track in a sequencer.

+

* The i/o settings of the channel pops up.

+

** Choose a gig file

+

** Choose an "instrument".A gig file can contain different "instruments".Basically a gig file is composed of a pool of sounds and some configuration possibilities of theses samples named "instruments". For example one instrument can load only the forte samples and apply some adsr on it, while another one can load every samples in the pool, and organize them as layers that will be triggered by the velocity applied on the controller. This way, very different types of of sound can be obtained from the same pool of samples, which is more efficient in terms of sound-design and disk space...

+

** Set the midi and audio i/o for the channel from the different drop-down lists. All the options you will find here were created earlier in the device configuration setup stored in your config template. If you would like to change some of it, you can also do it from here with the "midi input setup" and "audio output setup" buttons.

+

** Press ok.

+

* The channel is added to the main window and the gig file is loaded into RAM. Well, only the start of the sounds used in the instrument are cached in memory, the main task of LS will be to stream the biggest part of them directly from disk. That's how it's possible to load 30 GBs of samples with only 1 GB of ram.

+

* You should now be able to play your instrument from jack-keyboard or whatever controller is tied to LS.

+

If you get no sound, check the volume sliders both on the channel strip and on the main toolbar.

−

# To get only the sampler backend (no gui) :

+

* Repeat these steps as many times as you wish to complete your "sampling orchestra".

−

##

+

* Save your template under a new name so you keep your default template clean if you want to start another orchestra from ground.

−

## [http://aur.archlinux.org/packages.php?ID=28072 linuxsampler-cvs]

−

# If you want the gig file editor :

−

## [http://aur.archlinux.org/packages.php?ID=28073 gigedit-cvs]

−

# If you want a gui :

−

## [http://aur.archlinux.org/packages.php?ID=21688 liblscp-cvs]

−

## [http://aur.archlinux.org/packages.php?ID=21689 qsampler-cvs]

−

=Configure=

+

==Advanced topics==

−

* Creating a default template that autoconnects to jack

+

=== Filtering midi messages before they reach LS ===

+

Sometimes sample libraries do not agree with how a composer/arranger expects the sounds played by his MIDI software.

+

A concrete example would be a score editor connected to LS, playing a piano part in the C3 to C4 octave, but what is heard is really one octave higher (C4 to C5). Probably the layering of the samples in the gig file is offset by one octave.

+

If you are sure the mapping is incorrect (opening the gig file in live mode from qsampler can help), then here is some solutions :

−

=Advanced=

+

* Transpose the MIDI part one octave lower. In an orchestral score, this is very wrong to see notes on staff sounding one octave lower, especially when you already deal with transposing instruments...Also you would have to transpose back before printing.

−

== Filtering midi messages before they reach LS ==

+

* Redo the mapping inside the gig file. That would be the best solution as it definitely cures the problem. However this can be a lot of hassle if there is multiple instruments inside the file. Also some non-sounding notes are often reserved before the sounding ones to trigger some cc (keyswitches), making the remapping one octave lower more complex or even impossible.

−

Qmidiroute...

+

* The quick and non-destructive way here is to put a MIDI filter between the score editor and LS, that lowers the notes by one octave for the piano channel only. {{AUR|Qmidiroute}} can do that and it also monitors all midi messages along the way. You could for example check that the cc sent by the score are really what they should be (right midi ch, pan, velocity curves etc...)

+

If you use this setup, you will have to change the piano part MIDI output in your score editor to go to qmidiroute instead of LS, and the piano "channel" in LS to use the qmidiroute output instead of your score editor.

+

This also could be done at the orchestra level if you want to monitor every instrument in your score or if using multiple midi outputs in your score editor is not possible.

and eventually a crash after that, then it's time to reconsider latency for your souncard.

+

and eventually a crash after that, then it's time to reconsider latency for your soundcard.Raise the samples/period setting in qjackctl and retry. As an indication, on an M-audio delta 44, a setup of samples/period=128, periods in buffer=2 and sampling rate=44100 gives a working setup with LS.Latency = 5.8ms which is already quite low.

−

On a M-audio delta44 everything working at 5,8 ms.

−

=External Ressources=

+

==External Resources==

*[http://www.linuxsampler.org/index.php Homepage]

*[http://www.linuxsampler.org/index.php Homepage]

−

*[http://www.linuxmao.org/tikiwiki/tiki-index.php?page=linuxsampler French tutorial about LS]

+

*[http://www.linuxjournal.com/content/linuxsampler-project Article about LS on LinuxJournal]

Overview

Linuxsampler is a software audio sampler.It can be loaded with sound libraries in the gigasampler format (.gig).
One benefit of LS is it can stream the samples directly from hard disk, allowing the usage of huge libraries (several GBs..).LS can be started as a standalone application or lv2 or dssi plugin.Currently only the cvs build will provide those plugin versions.
By now, "Linuxsampler" refers to a group of software interacting together :

Quick Installation

All packages are available from the AUR.You have choice between release or cvs versions.
If you choose the release versions then the most simple way is installing a frontend via yaourt, which will cascade all necessary dependencies in the right order :

$ yaourt -S qsampler

This should build and install in this order : libgig, linuxsampler, liblscp and finally qsampler.
You could install jsampler instead of qsampler if you prefer this interface, or install it later. It's perfectly ok to have multiple frontends for LS in the system.

If you need the gig file editor :

$ yaourt -S gigedit

You can now run qsampler which will automatically start linuxsampler. If you use jsampler, you have to start linuxsampler first.

The (not so) long way

Installation

IMPORTANT NOTE 1 : Follow the installation order of theses components to get a working set of apps.
All packages are available from the AUR. You have choice between release or cvs versions.

You should choose between a full set of standard packages OR CVS packages but do not mix them.
Whatever you choose, but particularly with cvs packages, you should keep in a safe place a set of binary packages that work together.

The backend : Linuxsampler

It is the "engine" of the sampler, which performs all the heavy and time critical computational tasks of handling MIDI events, calculating the audio data and sending the final audio data to your sound card(s). LinuxSampler itself usually runs as own process in the background of the computer and usually does not show up anything on the screen, or at most it can be launched to show status information and debug messages in a console window. Usually you will also need a frontend to control it.

The editor : Gigedit

Gigedit allows you to edit and create instruments for the Gigasampler format, which can be used with LinuxSampler as well as with Tascam's Gigastudio. You can use gigedit as stand-alone application without Linuxsampler running or in live-mode, started from any frontend ("edit" button).In this case, all your modifications are audible in realtime.

Build and install (optional, you can skip this step if you do not need the editor): gigedit-svnAURorgigedit-cvsAUR

and check that everything is ok :

$ gigedit

The editor should pop-up in "stand-alone" mode as indicated in the down-right corner.
Close the window.

The frontend : Qsampler

This frontend provides the user a set of menus, buttons, sliders, dials, etc. to allow the user to control the sampler in a convenient way. It does not perform any signal processing tasks, so you can see it as a "face" of the sampler. From Qsampler you can load/unload .gig files into Linuxsampler and set their midi channel number, volume, jack output etc...and finally store all this setup in a file for a speedy re-opening of your "sampling orchestra".

On the left panel, click on "Audio Devices".Now we can see the audio drivers available in the right panel.

Choose "Jack" in the Driver menu.The default config should give you a pair of audio outputs at a sample rate of 44100.

Click on the Create button down the window.

Note : In some systems, qsampler crashes if this window is closed or even backgrounded while the Bottom-Right panel is still in view.Easy workaround : click on "Audio devices" or "Midi Devices" on the left panel before leaving or unfocusing the window.

If you want LS to auto-connect to jack system outputs when you launch your template :

On the left panel, click on "Audio Jack Device 0" , then on right panel select "Audio Jack 0" from the "Channel" drop-down list.

Choose an output for the JACK_BINDINGS parameter, like "system:playback 1".

If you want LS to auto-connect to jack-keyboard midi output when you launch your template :

Select the "Midi jack device" port 0" on the left panel.

On the right panel, for the "JACK_BINDINGS" parameter value, choose "jack-keyboard:midi out".

Note that if jack-midi is not enabled in Qjackctl, you won't find the midi client in the drop-down list.You can check in Qjackctl setup : "Midi driver" should be set to "seq".A restart of jack and qsampler is needed.

Also, if jack-keyboard or whatever midi controller you defined in here is not started before qsampler starts, you will likely receive an error from qsampler not finding the midi client.In that case, you can still start the midi device and connect it to LS through qjackctl.

Finally close the Devices Config window and save your template.

Tip: You can define as much midi ports as midi controllers you use. The same applies to audio outputs, e.g for sending separated instrument outputs for recording in Ardour.

Building a performance template in qsampler

Open qsampler and load your configuration template.

Press the "Add channel" button in the toolbar (Ctrl-A).A "channel" in the LS terminology is an object (visually a strip) which stores the settings for a given instrument : Name and location of the gig file, inputs & outputs used, midi channel, volume, solo/mute status, midi cc applied etc..much like a track in a sequencer.

The i/o settings of the channel pops up.

Choose a gig file

Choose an "instrument".A gig file can contain different "instruments".Basically a gig file is composed of a pool of sounds and some configuration possibilities of theses samples named "instruments". For example one instrument can load only the forte samples and apply some adsr on it, while another one can load every samples in the pool, and organize them as layers that will be triggered by the velocity applied on the controller. This way, very different types of of sound can be obtained from the same pool of samples, which is more efficient in terms of sound-design and disk space...

Set the midi and audio i/o for the channel from the different drop-down lists. All the options you will find here were created earlier in the device configuration setup stored in your config template. If you would like to change some of it, you can also do it from here with the "midi input setup" and "audio output setup" buttons.

Press ok.

The channel is added to the main window and the gig file is loaded into RAM. Well, only the start of the sounds used in the instrument are cached in memory, the main task of LS will be to stream the biggest part of them directly from disk. That's how it's possible to load 30 GBs of samples with only 1 GB of ram.

You should now be able to play your instrument from jack-keyboard or whatever controller is tied to LS.

If you get no sound, check the volume sliders both on the channel strip and on the main toolbar.

Repeat these steps as many times as you wish to complete your "sampling orchestra".

Save your template under a new name so you keep your default template clean if you want to start another orchestra from ground.

Advanced topics

Filtering midi messages before they reach LS

Sometimes sample libraries do not agree with how a composer/arranger expects the sounds played by his MIDI software.
A concrete example would be a score editor connected to LS, playing a piano part in the C3 to C4 octave, but what is heard is really one octave higher (C4 to C5). Probably the layering of the samples in the gig file is offset by one octave.
If you are sure the mapping is incorrect (opening the gig file in live mode from qsampler can help), then here is some solutions :

Transpose the MIDI part one octave lower. In an orchestral score, this is very wrong to see notes on staff sounding one octave lower, especially when you already deal with transposing instruments...Also you would have to transpose back before printing.

Redo the mapping inside the gig file. That would be the best solution as it definitely cures the problem. However this can be a lot of hassle if there is multiple instruments inside the file. Also some non-sounding notes are often reserved before the sounding ones to trigger some cc (keyswitches), making the remapping one octave lower more complex or even impossible.

The quick and non-destructive way here is to put a MIDI filter between the score editor and LS, that lowers the notes by one octave for the piano channel only. QmidirouteAUR can do that and it also monitors all midi messages along the way. You could for example check that the cc sent by the score are really what they should be (right midi ch, pan, velocity curves etc...)

If you use this setup, you will have to change the piano part MIDI output in your score editor to go to qmidiroute instead of LS, and the piano "channel" in LS to use the qmidiroute output instead of your score editor.
This also could be done at the orchestra level if you want to monitor every instrument in your score or if using multiple midi outputs in your score editor is not possible.

Troubleshooting

If you get the message :
Engine: WARNING, CONFIG_EG_MIN_RELEASE_TIME too big for current audio fragment size & sampling rate!
and eventually a crash after that, then it's time to reconsider latency for your soundcard.Raise the samples/period setting in qjackctl and retry. As an indication, on an M-audio delta 44, a setup of samples/period=128, periods in buffer=2 and sampling rate=44100 gives a working setup with LS.Latency = 5.8ms which is already quite low.