Skip to content
Multi-platform lightweight music player
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


MagicPlayer is a multi-platform lightweight music player. It is mostly developed for myself, but as it is free and open source, if you don't like powerful and full-featured music players, you can use it.

Warning: the project is still in an early stage, and a lot is still to be done.


Tested on Windows and Linux.


Supported audio formats are WAV (PCM only), OGG/Vorbis, FLAC and MP3 (MPEG 1.0/2.0/2.5 layer I/II/III). (more details here).

The GUI is separated in several views that can be resized and moved/docked. Currently implemented views are:

  • Player: used to control playing music and volume
  • Explorer: used to select audio files to play
  • Theme config: used to select color theme or choose custom colors
  • Log viewer: used to see internal logs (useful to debug)


Libraries used:

  • Dear ImGui: Bloat-free Immediate Mode Graphical User interface for C++ with minimal dependencies
  • imgui-sfml: ImGui binding for use with SFML
  • SFML: Simple and Fast Multimedia Library
  • libmpg123: Fast and Free real time MPEG Audio Layer 1, 2 and 3 decoding library
  • spglog: Fast C++ logging library
  • utfcpp: UTF-8 with C++ in a Portable Way

All libraries are built with MagicPlayer except libmpg123 which must be installed on Linux and is embedded on Windows.

Also, on Linux systems, if SFML is installed, by default the system version is used. To force SFML to be built with MagicPlayer, set CMake option COMPILE_SFML_WITH_PROJECT to ON.

Fonts used:

Font Awesome is used with C++ headers generated by a script from IconFontCppHeaders.

Supported audio formats

MagicPlayer uses SFML and libmpg123 to decode audio files, so it should support all audio formats stated in the documentation of these libraries.

Extract of SFML documentation:

SFML supports the audio file formats WAV, OGG/Vorbis and FLAC. Due to licensing issues MP3 is not supported. 

Extract of libmpg123 documentation:

Features include: decoding of MPEG 1.0/2.0/2.5 layer I/II/III audio streams to interleaved PCM, also free-format bitrates over 320 kbit/s


Don't forget to pull the submodules with the repository using --recursive:

git clone --recursive

or if you have already cloned the repository:

git submodule init
git submodule update

To build the project you will need a C++17 compliant compiler. The project uses CMake to build, see Running CMake for more information.

On linux, a common CMake use is:

$ mkdir cmake-build
$ cd cmake-build
$ cmake ..
$ make

On Windows, there is batch files available to configure a Visual Studio project in the ide folder.


At the moment MagicPlayer must be run in the folder containing the resources folder, otherwise fonts can't be loaded.


This work is under the MIT License

Read the license file

You can’t perform that action at this time.