Vesper

Local music player... with immediate mode gui, ID3 tags, album art, lyrics

⚠️ Archived / Legacy Project — This version of Vesper is preserved for historical reference. It is functional but unstable.
The project has been fully rewritten as Vesp4X, which features a modernized stack and improved stability.
Link to new repository: Vesp4X

---

Features

• Modern dark interface (ImGui + GLFW)
• Tag parsing and album art display
• Automatic lyrics fetching from lrclib.net
• Streaming audio playback (OpenAL + FFmpeg)
• Cross-platform: Windows ⋅ Linux ⋅ macOS

---

Build Requirements & Setup

Vesper uses CMake and depends on several libraries. Below are instructions for each platform.

Common

• CMake 3.28 – 4.2 (latest recommended)

Windows (Recommended: MSVC + vcpkg)

Install dependencies via vcpkg:

./vcpkg install openal-soft ffmpeg[avcodec,avformat,avutil,swresample]  --triplet x64-windows

Build Vesper:

git clone https://github.com/aprentxdev/Vesper.git  
cd Vesper  
cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=[path_to_vcpkg]/scripts/buildsystems/vcpkg.cmake  
cmake --build build --config Release  

Linux/macOS

Ubuntu/Debian:

sudo apt install build-essential cmake pkg-config \
    libopenal-dev libavformat-dev libavcodec-dev libavutil-dev libswresample-dev \
    libx11-dev libxrandr-dev libxinerama-dev libxcursor-dev libxi-dev

Other systems:

• Arch: pacman -S base-devel openal ffmpeg
• Fedora: dnf install openal-soft-devel ffmpeg-devel
• macOS: brew install cmake openal-soft ffmpeg

Then build:

git clone https://github.com/aprentxdev/Vesper.git
cd Vesper
cmake -B build -S .
cmake --build build

---

Runtime Dependencies (for file dialogs)

• Linux/MacOS: zenity (apt/dnf/brew install zenity)
• Windows: No external dependencies (uses native API for file dialogs).

note: Will be replaced with 'nativefiledialog'

---

Third-Party Fonts

Fonts included in the fonts/ folder:

• Font Awesome — MIT License
• Rubik — SIL Open Font License (OFL)

Full license texts and required notices are in the 3RDPARTY-LICENSES/ folder.

License

Vesper is licensed under the MIT License

Credits & Thanks

• To the authors of all used libraries and fonts
• To lrclib.net for free lyrics database