How lieff/minimp3 works
minimp3 is a compact, single-header MP1/MP2/MP3 decoder; its optional high-level API adds file/buffer decoding, precise seeking, and track-length detection. The main user workflow supplies MP3 bytes and receives decoded PCM, while the bundled SDL player adds playlist selection and playback. The graph also preserves the player’s UI, rendering, image, font, and platform-support components. Core decode and player call paths are supported by excerpts; high-level API relationships are documented in the README, while some player internals were not sampled.
Main entry points: player.cpp Player App · minimp3.h Frame Decoder · audio_sdl.c SDL Audio Output · decode.c Player Decoder Adapter
Components 17
Decoder Library
- Frame Decoder
minimp3.h
Stream API
- High-Level Decoder
minimp3_ex.h
SDL Player
- Player App
player/player.cpp - Player Decoder Adapter
player/decode.c - Player Decoder API
player/decode.h - SDL Audio Output
player/audio_sdl.c - Audio API
player/audio_sdl.h - Platform Primitives
player/system.cpp - Platform API
player/system.h
Player UI
- Nuklear UI Backend
player/nuklear_sdl_gl3.h - Nuklear UI
player/nuklear.h - Theme Styling
player/style.h - Embedded Font
player/FreeSans.h - Image Loading
player/stb_image.h - OpenGL Loader
player/glad.h
Other components
- MP3 Input
- Audio Device
Connections 18
- MP3 Input → Frame Decoder: decodes frames
README.md - Frame Decoder → MP3 Input: consumes bytes
README.md - Frame Decoder → High-Level Decoder: supports API
README.md - Player App → Player Decoder Adapter: opens track
player/player.cpp - Player App → Audio API: controls output
player/player.cpp - Audio API → SDL Audio Output: declares interface
player/audio_sdl.h - SDL Audio Output → Player Decoder Adapter: requests samples
player/audio_sdl.c - SDL Audio Output → Audio Device: plays PCM
- Player App → Nuklear UI Backend: renders UI
player/player.cpp - Nuklear UI Backend → Nuklear UI: uses toolkit
- Player App → Theme Styling: sets theme
player/player.cpp - Player App → Embedded Font: loads font
player/player.cpp - Player App → Image Loading: loads images
player/player.cpp - Player App → OpenGL Loader: uses graphics
player/player.cpp - Player Decoder Adapter → Player Decoder API: implements API
player/decode.c - Player Decoder API → High-Level Decoder: includes API
player/decode.h - Player App → Platform API: uses primitives
- Platform API → Platform Primitives: implemented by
player/system.cpp