Qsampler - A LinuxSampler Qt GUI Interface
------------------------------------------

Qsampler is a LinuxSampler GUI front-end application written in C++ around
the Qt framework using Qt Designer. At the moment it just wraps as a client
reference interface for the LinuxSampler Control Protocol (LSCP).

LinuxSampler is a work in progress. The goal is to produce a free, open source
pure software audio sampler with professional grade features, comparable to
both hardware and commercial Windows/Mac software samplers.

The initial platform will be Linux because it is one of the most promising
open source multimedia operating systems. Thanks to various kernel patches
and the Jack Audio Connection Kit, Linux is currently able to deliver rock
solid sub-5 millisecond MIDI-to-Audio response.

Homepage: https://qsampler.sourceforge.io
          http://qsampler.sourceforge.net

See also: https://www.linuxsampler.org

License: GNU General Public License (GPL)


Requirements
------------

The software requirements for build and runtime are listed as follows:

  Mandatory:

  - Qt framework, C++ class library and tools for
        cross-platform application and UI development
        https://qt.io/

  - liblscp, C library for LinuxSampler control protocol API.
        https://www.linuxsampler.org/

  Optional (opted-in at build time):

  - libgig, C++ library for loading and modifying Gigasampler and DLS files.
        https://www.linuxsampler.org/libgig/


Installation
------------

The installation procedure follows the standard for source distributions.
Unpack the tarball and in the extracted source directory:

    ./configure [--prefix=/usr/local]
    make

and optionally as root:

    make install

This procedure will end installing the following couple of files:

    ${prefix}/bin/qsampler
    ${prefix}/share/pixmaps/qsampler.png
    ${prefix}/share/applications/qsampler.desktop
    ${prefix}/share/locale/qsampler_*.qm

Just launch ${prefix}/bin/qsampler and you're off (hopefully).

Note that the default installation path ${prefix} is /usr/local.

If you're checking out from Git, you'll have to prepare the
configure script just before you proceed with the above instructions:

   ./autogen.sh


Configuration
-------------

Qsampler holds its settings and configuration state per user, in a
file located as $HOME/.config/linuxsampler.org/Qsampler.conf .
Normally, there's no need to edit this file, as it is recreated and
rewritten everytime qsampler is run.


Bugs
----

Plenty as this is still alpha software. Bug reports should be posted on
LinuxSampler bug tracker (https://bugs.linuxsampler.org).


Support
-------

Qsampler is open source free software. For bug reports, feature requests,
discussion forums, mailling lists, or any other matter related to the
development of this piece of software, please use the LinuxSampler project
site (https://www.linuxsampler.org).


Enjoy.

rncbc aka Rui Nuno Capela
rncbc at rncbc dot org
https://www.rncbc.org
