libgig

libgig is a C++ library for loading, modifying existing and creating new GigaStudio/Gigasampler (.gig) files and DLS (Downloadable Sounds) Level 1/2 files, KORG sample based instruments (.KSF and .KMP files), SoundFont v2 (.sf2) files and AKAI sampler data. The source code package includes a couple of command line tools based on the library. The library and tools are released in source code format under the GNU General Public License, except the AKAI classes which are released under the GNU Lesser General Public License.

This library is developed and optimized for POSIX compliant operating systems like Linux and OSX and since release 3.1.1 for Windows as well. libgig was developed to compile on any operating system. There are some very few build requirements though:

Since release 3.0.0 libgig uses one tiny operating system dependant method to be able to resize files. Should be a 5 minute job to implement this method for other operating systems as well though.
Since release 4.3.0, at least a C++11 compliant compiler is required to build libgig from source.
Since release 4.3.0, an UUID generating function is required to be provided by the underlying OS. In previous libgig versions this was an optional feature, its absence only prevented gig files modified by libgig potentially from being accepted by Tascam's GigaStudio. It dit not mean any restriction with LinuxSampler though, this has changed in the meantime so this is now a hard build requirement.

Source Code

Version File Name File Size Date

4.4.1 libgig-4.4.1.tar.bz2 576K 20-Feb-2024 17:32

4.4.0 libgig-4.4.0.tar.bz2 576K 26-Jan-2024 19:04

4.3.0 libgig-4.3.0.tar.bz2 744k 09-May-2021 12:56

4.2.0 libgig-4.2.0.tar.bz2 729k 25-Jul-2017 13:10

4.1.0 libgig-4.1.0.tar.bz2 526k 25-Nov-2017 13:52

4.0.0 libgig-4.0.0.tar.bz2 684k 14-Jul-2015 18:36

3.3.0 libgig-3.3.0.tar.bz2 330k 30-Jul-2009 10:35

3.2.1 libgig-3.2.1.tar.bz2 316k 05-Dec-2007 16:33

3.2.0 libgig-3.2.0.tar.bz2 329k 14-Oct-2007 16:52

3.1.1 libgig-3.1.1.tar.bz2 294k 24-Mar-2007 19:26

3.1.0 libgig-3.1.0.tar.bz2 294k 24-Nov-2006 14:03

3.0.0 libgig-3.0.0.tar.bz2 275k 28-Apr-2006 20:05

2.0.2 libgig-2.0.2.tar.bz2 255k 15-Aug-2005 19:34

2.0.1 libgig-2.0.1.tar.bz2 241k 13-June-2005 02:18

2.0.0 libgig-2.0.0.tar.bz2 61k 10-May-2005 12:08

1.0.0 libgig-1.0.0.tar.bz2 67k 26-Nov-2004 23:39

0.7.1 libgig-0.7.1.tar.bz2 56k 09-July-2004 00:13

0.7.0 libgig-0.7.0.tar.bz2 253k 03-May-2004 16:51

0.6.0 libgig-0.6.0.tar.bz2 336k 20-Dec-2003 05:41

See Changelog for details.


Version	File Name	File Size	Date
4.4.1	libgig-4.4.1.tar.bz2	576K	20-Feb-2024 17:32
4.4.0	libgig-4.4.0.tar.bz2	576K	26-Jan-2024 19:04
4.3.0	libgig-4.3.0.tar.bz2	744k	09-May-2021 12:56
4.2.0	libgig-4.2.0.tar.bz2	729k	25-Jul-2017 13:10
4.1.0	libgig-4.1.0.tar.bz2	526k	25-Nov-2017 13:52
4.0.0	libgig-4.0.0.tar.bz2	684k	14-Jul-2015 18:36
3.3.0	libgig-3.3.0.tar.bz2	330k	30-Jul-2009 10:35
3.2.1	libgig-3.2.1.tar.bz2	316k	05-Dec-2007 16:33
3.2.0	libgig-3.2.0.tar.bz2	329k	14-Oct-2007 16:52
3.1.1	libgig-3.1.1.tar.bz2	294k	24-Mar-2007 19:26
3.1.0	libgig-3.1.0.tar.bz2	294k	24-Nov-2006 14:03
3.0.0	libgig-3.0.0.tar.bz2	275k	28-Apr-2006 20:05
2.0.2	libgig-2.0.2.tar.bz2	255k	15-Aug-2005 19:34
2.0.1	libgig-2.0.1.tar.bz2	241k	13-June-2005 02:18
2.0.0	libgig-2.0.0.tar.bz2	61k	10-May-2005 12:08
1.0.0	libgig-1.0.0.tar.bz2	67k	26-Nov-2004 23:39
0.7.1	libgig-0.7.1.tar.bz2	56k	09-July-2004 00:13
0.7.0	libgig-0.7.0.tar.bz2	253k	03-May-2004 16:51
0.6.0	libgig-0.6.0.tar.bz2	336k	20-Dec-2003 05:41

Binary Packages

For Windows you can find a precompiled DLL of libgig, coming with the example command line tools as .exe files, packed into one .zip file. For Linux there are currently Debian packages and RPM packages for Redhat / Fedora, SuSE and Mandrake. Note that libgig is already part of many distributions. You might want to use packages coming with your distribution instead.

Tools

The libgig sources and the 'gigtools' Debian package contain the following command line tools:

gigextract (Extracts samples from a .gig file)
gigdump (Prints out the content of a .gig file)
gigmerge (Merges several .gig files to one .gig file)
gig2mono (Converts .gig files from stereo to mono)
gig2stereo (Converts .gig files to true interleaved stereo sounds)
korgdump (Prints out the content of the various KORG file types)
korg2gig (Convert KORG sound file to Gigasampler/GigaStudio format)
sf2dump (Prints out the content of a .sf2 file)
sf2extract (Extracts audio samples from a .sf2 file)
akaidump (Dump an AKAI media i.e. from a CDROM drive as disk image file to your hard disk drive)
akaiextract (Extracts samples from an Akai disk image, either from a media i.e. CDROM or Zip drive, from a AKAI disk image file)
dlsdump (Prints out the content of a DLS file)
rifftree (Prints out the RIFF tree structure of an arbitrary RIFF file)

Documentation

Online API Documentation for the latest libgig version (automatically updated to latest version from SVN) (HTML)

Old kick start documentation for libgig (OpenOffice, PDF)

Examples

There are couple of example applications which demonstrate how to use the library. Beside the mentioned tools coming with the source packages, there are also the following demo applications (only in source code format):

gigwritedemo.cpp (demonstrates how to create and modify Gigasampler format files)
dlswritedemo.cpp (demonstrates how to create and modify DLS Level 1/2 files)
riffwritedemo.cpp (demonstrates how to create and modify RIFF files in general)

Applications

Besides LinuxSampler and its related programs (e.g. qsampler, gigedit), the following third party applications are also using libgig to access Gigasampler format files:

Capture

You are also using libgig for your application? Please let me know!

Diagrams

UML static structure diagram focused on the aspect of actually using the library (created with TCM):

Version File Formats Date

1.0.0 TCM, PDF, PostScript 26-Nov-2004 21:18

0.7.x TCM, PDF, PostScript 03-May-2004 17:36

0.6.0 TCM, PDF, PostScript 20-Dec-2003 05:41

(Sorry, these UML diagrams are a bit outdated).


Version	File Formats	Date
1.0.0	TCM, PDF, PostScript	26-Nov-2004 21:18
0.7.x	TCM, PDF, PostScript	03-May-2004 17:36
0.6.0	TCM, PDF, PostScript	20-Dec-2003 05:41

Subversion

You can check out the latest development version of libgig from the LinuxSampler Subversion server:

svn co https://svn.linuxsampler.org/svn/libgig/trunk libgig

You can also browse the libgig Subversion repository.

Author

This library was written by Christian Schoenebeck (PGP/GPG Public Key).

Licensing

libgig and its tools are released under the GNU General Public License, except the AKAI classes which are released under the GNU Lesser General Public License

Contact

You can either send emails to the LinuxSampler Developers Mailing List or contact me directly.

Happy hacking!
Christian