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!
- 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.
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