mpg123 decoder plugin for GStreamer
C Python
Switch branches/tags
Nothing to show
Latest commit f9c8afa Nov 11, 2012 @dv1 dv1 Backported gst-plugins-bad mpg123audiodec fixes
* finalizer was unnecessary and introduced a leak
* last MPEG frame wasn't being decoded
* Changed default GStreamer version from 0.10 to 1.0 in wscript
* Cleaned up log levels



This is gstmpg123, a GStreamer plugin for MP3 decoding, using the mpg123 library. Currently, it is written for GStreamer 0.10.36 (the 0.10 branch) and 1.0.0 (the 1.0 branch).

mpg123 is a free mp3 decoder, released under the LGPL. It consists of a C library and a command-line client.


  • GStreamer 0.10.36 or a new version in the 0.10 branch or GStreamer 1.0.0 or a new version in the 1.0 branch
  • mpg123 1.13.0

Build instructions


./waf -h

To get a list of options. --prefix, --plugin-install-path-0-10, --plugin-install-path-1-0 are particularly interesting for local GStreamer installations and for cross compilings.

GStreamer 1.0

This plugin makes use of the waf build system. For building, call:

./waf configure build

Then, to install the plugin, call:

./waf install

(build_1_0 for building and install_1_0 also work).

GStreamer 0.10

Similar to the 0.10 build, call:

./waf configure build_0_10

Then, to install the plugin, call:

./waf install_0_10


This plugin has been included in the gst-plugins-bad package since version 1.0.0. Most Linux distributions have started to support GStreamer 1.0 and offer it in their package repositories. If GStreamer 1.0 packages are available to you, it is recommended to install the gst-plugins-bad package use its prebuilt mpg123 plugin instead.