gst-nonstream-audio

About

This is a set of plugins for GStreamer 1.0 audio decoders which are not based on a streaming model. These decoders load the encoded data completely, at once, and then commence playback. Examples are: module music (MOD, S3M, XM, IT, ...) , video game music (VGM, GYM, GBS, ...) various Amiga music files, AdLib music, etc.

GStreamer's GstAudioDecoder base class is very powerful, and suitable for most kinds of audio decoders. However, it assumes a certain kind of model that is simply not applicable for the aforementioned types of media. Using that base class for this purpose ends up in massive amounts of overrides, effectively creating a new base class. So it was decided to do just that - create a new bass class, called GstNonstreamAudioDecoder. It takes care of most GStreamer specifics and adds support for subsongs (essentially like alternate tracks in the same song) and loops (songs can contain loops, which cause playback to go back to the beginning, or playback loops in a subset of the song).

PLEASE NOTE THAT THIS CODE IS STILL IN AN ALPHA STAGE! Compatibility-breaking changes may happen!

Available plugins

• dumb : module music decoder using the DUMB (Dynamic Universal Music Bibliotheque) library. Instead of the original, which has been abandoned since 2005, the plugin uses kode54's improved version. Note that the plugin will not work correctly with the original; however, this codebase contains the improved version as a git submodule.
• gme : video game music decoder using the Game Music Emulator library. As with DUMB, an improved fork is used.
• openmpt : module music decoder using libopenmpt, a library version of OpenMPT.
• wildmidi: MIDI music decoder using the WildMidi software synthesizer.
• sidplayfp: SID music decoder using the sidplayfp library.
• uade: Amiga music decoder using UADE.

How to build

Right after git-cloning this repository, run:

git submodule init
git submodule update

Then, execute this line:

./waf configure

To build and install after configuring, simply run:

./waf
./waf install

Now there should be a dumbdec plugin. To check, run:

gst-inspect-1.0 dumbdec