JSampler is an opensource, platform-independent, GUI front-end for LinuxSampler, written entirely in Java. The main goal of the JSampler's design is to be extensible and more flexible regarding the integration of different GUI implementations. JSampler consists of two parts:

The main reason for that is the TCP/IP based communication between the LinuxSampler and its front-ends, enabling the sampler to be controlled from another computer or device, which may have different display requirements and limitations.

A JSampler distribution consist of the JSampler core and at least one view, providing the GUI implementation. Each distribution has its own name, which is based on the integrated view extension. Currently, there are two distributions:

Currently, there are two distributions available for download - JS Classic and Fantasia.

The source code is available in the JSampler package, which also contains this manual and startup scripts that can be used to run a particular JSampler distribution.

The latest source code can be obtained from cvs with the following command:

cvs -z3 -d:pserver:anonymous@cvs.linuxsampler.org:/var/cvs/linuxsampler co jsampler

To run JSampler you need Java Runtime Environment (JRE) version 6 or higher. The latest version can be downloaded from here.

To build JSampler distribution from source you need JDK version 6.0 or higher and the Ant tool.

Let's assume that you want to run from the command line JS_Classic-0.8a.jar, which is located in /home/me/soft directory. First you should check whether the java command is in your path and the version requirements are met. This can be done by issuing the following command:

java -version

If the version is 1.6.0 or higher you can run JS Classic by issuing the following command:

java -jar /home/me/soft/JS_Classic-0.8a.jar

Otherwise, if the shell response is something like

bash: java: command not found

or the version requirements are not met, make sure that you have installed JRE (or JDK) with the proper version and find its location:

The shell should return something like:

Now, we know that we have a JDK with a proper version installed and its location is /opt/jdk1.6.0. In that case, to run JS Classic issue the following command:

/opt/jdk1.6.0/bin/java -jar /home/me/soft/JS_Classic-0.8a.jar

There are scripts In the scripts directory of the JSampler package that, with a little adjustments (if needed), can be used to run a JSampler distribution. Copy them to a desired location and edit with your preferred editor.

This configuration is optional, but necessary if you want to run jar files by (double) clicking on them. In Gnome, by default jar files are opened with the Archive Manager. To change that, run a file browser, right click on an arbitrary jar file and choose Properties, than go to the Open With tab and click the Add button.

In the Add Application dialog click onto Use a custom command label and a text field will appear below. If the location of your JRE is /opt/jre1.6.0, then enter the following command in the text box:

/opt/jre1.6.0/bin/java -jar

And then click the Add button.

To add an application launcher to a Gnome panel, right click on the panel and choose Add to Panel.

Then select Custom Application Launcher and click the Add button. In the Command field, of the Create Launcher dialog, fill in the exact command that you use to run the JSampler. For more information on how to run a JSampler distribution from the command line click here.

To run JSampler distribution on Windows, put a shortcut on the Desktop or Quick Launch, right click on the shortcut and choose Properties. In the Target field insert the command javaw -jar in the beginning.

When building from CVS, there are some additional steps that should be done. JSampler uses two additional libraries, that should be downloaded and placed in the lib/required directory:

Download these libraries, create a lib/required directory in the JSampler root and copy the jlscp.jar and juife.jar files in that directory:

Then follow the steps in the next section.

To build a JSampler distribution, first set the JAVA_HOME environment variable to point to your JDK directory. If the JDK is installed in /opt/jdk1.6.0 directory, this can be done by issuing the following command:

export JAVA_HOME=/opt/jdk1.6.0

Windows users should do something like:

set JAVA_HOME=c:\jdk1.6.0

Go to the JSampler root directory and issue the following command:

ant [target]

Where target can be one of the following:

So, if you want to build a JS Classic distribution, just issue the following command:

ant build-jsclassic

Then copy the jar file from the dist directory to the desired location.

Tool buttons:

Create new orchestra

Edit selected orchestra

Remove selected orchestra

To create a new orchestra, click on the Orchestras tab then click the Create new orchestra button in the Manage Orchestras tool:

Then choose orchestra name and description and click OK button.

To remove an orchestra, select the orchestra and click the Remove selected orchestra button. To edit an orchestra, select the orchestra and click the Edit selected orchestra button, or just double-click the orchestra to edit.

Tool buttons:

Add new instrument

Edit selected instrument

Remove selected instrument

To add a new instrument to orchestra, first select the desired orchestra from the combobox then click the Add new instrument button:

To remove an instrument, select the instrument and click the Remove selected instrument button. To edit an instrument, select the instrument and click the Edit selected instrument button, or just double-click the instrument to edit.

To load an instrument from orchestra to a sampler channel, right-click on the instrument, select Load Instrument, then choose on which channel to load the selected instrument. You can also load an instrument from orchestra to a sampler channel using the instrument chooser of the sampler channel - click Select instrument from orchestra radio button, choose orchestra and isntrument from the comboboxes and click OK button.