Gmu Music Player

Gmu is an open source music player for portable gaming consoles and handhelds. There are versions available for the GP2X (both F100 and F200 devices are supported), the GP2X Wiz, the Caanoo, the Dingoo A320/A330, the Ben NanoNote, the Pandora handheld and the Zipit Z2. Gmu supports lots of audio file formats and includes various features. For an overview have a look at the features list below.

Gmu Music Player
  • Supports Ogg Vorbis, Ogg Opus, MP3, MP2, Musepack (MPC), FLAC, WavPack, Speex and various module formats (MOD, XM, IT, S3M, STM, ...)
  • M3U playlist import/export
  • PLS playlist import
  • Internet audio streaming (web radio)
  • Various play modes including random and repeat modes
  • File browser
  • Playlist
  • Cover viewer (Gmu supports jpg, png and bmp image files and cover images embedded into ID3v2 tags)
  • Graphical spectrum analyzer
  • Hold function (turns off display backlight for power saving)
  • Customizable key mappings and skin support to be able to change Gmu's look & feel
  • In addition to the SDL frontend, there is a new ncurses text interface (usable over the network!)
  • There is also an experimental WebSocket-based browser interface (Gmu's webserver is listening on port 4680)

By the way, Gmu has been mentioned in an article in the German magazine "LinuxUser" issue 04/2008. The article is available on their website as well.

The Gmu source code is also available on Github.

Source gmu-0.10.1.tar.gz (487 KB)
md5sum: 98146012ce9b5e8971162796a0be17e3

Source gmu-0.10.0.tar.gz (493 KB)
md5sum: 6fda24acfd63bbda56e5fe227b2e5027

Zipit Z2 OpenWRT build (475 KB)
md5sum: b746a7595e58f5b2360661c85de49cba

Older versions
gmu-0.9.1.pnd (Pandora package, 2.5 MB)
md5sum: a922a8bdba055b34e20858eea19d1180 (Caanoo package, 0.7 MB)
md5sum: 57f62f94f6d89a69fed1a02877804dc1 (Open Dingux package, 0.7 MB)
md5sum: 5d0f592f3240783c7ad0301f4130dc21

gmu-0.9.1.tar.gz (Source, GPLv2, 0.5 MB)
md5sum: b9beb8ae21828c637821fcc98b989603 (GP2X and Wiz version)
725 KB, md5sum: 400e08bb7e2be3266d9b96a1c7405579 (Dingoo A320/A330 [Dingux] version)
775 KB, md5sum: 8a05ac8fcfc040b2e36ebb52cd0d5e31

gmu-0.8.0beta1.pnd (Pandora version)
1.4 MB, md5sum: dba836ffcd3937b0a0d8d86b73c0e1b4 (Zipit Z2 [uClibc] version)
245 KB, md5sum: d61f9f7da4a88d3e1432e2e34a90580e

gmu-0.8.0BETA1.tar.gz (GPLv2 source)
240 KB, md5sum: a1a3d346802f3877b4c739b3c65225d6
wej (web) says:
2021-10-26 00:06:03
feral dabz: Hard to tell what exactly is going on since I don't have a RG300 myself, but if the pause symbol is visible when trying to play a file, Gmu is usually unable to properly open the audio device. This could be caused by various things. Maybe some other application uses the audio device at the same time and blocks it. Just guessing…
pdrift (web) says:
2022-06-20 18:02:20
Is there a way to get this working on a raspberry pi zero 2?
wej (web) says:
2022-06-23 19:41:27
pdrift: Yes, it is possible to get Gmu running on any of the Raspberry Pi models. If you are so inclined, you could build it from source. It is not that difficult to do.
goocy (web) says:
2022-06-25 12:32:26
Is there a way to add a soundfont for playing MIDI files?
libmodplug mentions a MMPAT_PATH_TO_CFG variable that points to timidity.cfg, but I don't know if this is user-configurable.
Roland (web) says:
2022-08-29 19:22:49
I tried to compile it from the sources to my Debian x86 Notebook. How ca i install them on this machine?
Roland (web) says:
2022-09-02 11:09:35
I want to use GMU on a tiny Notebook (GPD) with installed Debian. I tried to compile it but got an error with 'make install'. How can i install them in Debian x64?
wej (web) says:
2022-09-06 18:23:13
Roland: Any details on the exact error? You do not necessarily need to install Gmu via make install. You could also just run it in place by executing ./gmu.bin from the build directory.
Roland (web) says:
2022-09-10 10:08:11
@wej, thank you for your support. I tried to start the gmu.bin file, it isn't possible. When i compile i get following error:

-e Compiling src/core.c
src/core.c:22:10: fatal error: SDL.h: Datei oder Verzeichnis nicht gefunden
#include "SDL.h" /* For audio output */
compilation terminated.
Makefile:124: recipe for target 'core.o' failed
make: *** [core.o] Error 1
wej (web) says:
2022-09-11 07:48:54
Roland: You need to install the dependencies required by Gmu. In this case, it is complaining about the missing SDL library. To compile Gmu, you also need the development packages of the dependencies. The latest stable version of Gmu required SDL 1.2, but there now is also a version using SDL 2, which you can get via github. Please check the README file for all the dependencies.
pdrift (web) says:
2023-03-08 04:25:24
Hello, I'd like to install GMU on a raspberry pi. I asked several years ago for help but I could not get it to work and i forgot about it. I recently dusted off my Z2 and fell in love with GMU again. What is the easiest way to get GMU on a raspberry pi?
wej (web) says:
2023-03-08 15:28:06
pdrift: Probably the easiest way to get Gmu running on a Raspberry Pi is to compile it locally on the Pi. That way you avoid cross-compiling alltogether.

To do that, you have to install a C compiler on the Raspberry Pi and some dependencies of Gmu, such as the development packages of SDL2 and libmpg123. On Debian-based distros such as Raspberry Pi OS, you should be able to install the compiler by installing the build-essential meta package.

Once all that has been installed, all you need to do is download the Gmu sources and run the following commands from within the Gmu source directory:


Compiling won't take very long, even on a Raspberry Pi. When the compilation succeeds, there should be a gmu.bin file which you can run:


There is some more information in the included file.
CHG (web) says:
2023-08-19 23:50:09
Can the Gmu music player produce a version that supports Chinese? Thank you!
wej (web) says:
2023-08-25 12:59:19
CHG: Gmu as of now does not natively support Chinese. Internally Gmu uses UTF-8 for representing characters, so that part should work fine with Chinese characters, but the rendering of text in Gmu's user interface has traditionally been done with bitmap fonts that only support a limited number of characters. I'm in the process of updating Gmu such that it also supports TrueType fonts, which will allow rendering of pretty much any Unicode character. That should help considerably with native support for Chinese (and many other languages using non-latin characters).

Until then, there is a Gmu fork that appears to support Chinese:

I don't know much about it, but it might be worth checking out.
Adrenl (web) says:
2024-02-02 08:31:19
A very good software.
Hope to add MIDI support.
Previous comments »

Leave a comment