https://github.com/secharvet/imsidplayer
A modern, lightweight, and cross-platform Commodore 64 SID music player built with C++20 and Dear ImGui
https://github.com/secharvet/imsidplayer
audio commodore-64 imgui retro sid-player
Last synced: 4 months ago
JSON representation
A modern, lightweight, and cross-platform Commodore 64 SID music player built with C++20 and Dear ImGui
- Host: GitHub
- URL: https://github.com/secharvet/imsidplayer
- Owner: secharvet
- Created: 2025-12-20T23:11:12.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-24T23:16:09.000Z (5 months ago)
- Last Synced: 2026-01-25T08:42:49.748Z (5 months ago)
- Topics: audio, commodore-64, imgui, retro, sid-player
- Language: C++
- Homepage:
- Size: 6.72 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG_v0.0.23.md
Awesome Lists containing this project
README
# imSid Player
**Alpha - Work In Progress**
A SID file (Commodore 64) player for Linux and Windows with a modern graphical interface using ImGui.
## Download
📦 **[Download latest release](https://github.com/secharvet/imsidplayer/releases/latest)**
> **Built from source on GitHub CI** - All releases are automatically built from public source code using GitHub Actions. SHA256 hashes are available in the release assets for verification.
### ⚠️ Windows SmartScreen Warning
**imSidPlayer is an unsigned indie executable.**
To run it:
1. Click **"More info"**
2. Click **"Run anyway"**
Source code is public and reproducible via GitHub Actions. Enjoy! 🎵
✨ Key Features
- **High-Quality SID Emulation**: Accurate playback of classic C64 sound chips (6581/8580).
- **ImGui-Powered UI**: A fast, customizable, and clutter-free interface.
- **Library Management**: Easily browse large collections of SID files with a hierarchical tree view.
- **Rating System**: Integrated star rating system to keep track of your favorite tracks.
- **Playlist Support**: Create and manage custom playlists.
- **Voice Analysis**: 3 parallel engines with individual voice control and real-time oscilloscopes.
- **Smart Search**: Fuzzy search with metadata indexing and filters (author, year).
- **Cross-Platform**: Designed to be compiled and run on Linux, Windows, and macOS.
## Quick Start
### Prerequisites
```bash
# Ubuntu/Debian
sudo apt-get install -y build-essential cmake libsdl2-dev libsdl2-image-dev libsidplayfp-dev pkg-config
```
### Build
```bash
mkdir build && cd build
cmake ..
make -j$(nproc)
./bin/imSidPlayer
```
## Configuration
Configuration files are stored in `~/.imsidplayer/`:
- `config.txt` - Application settings
- `background/` - Background images directory
- `database.json` - SID metadata library
You can drag & drop images anywhere in the application to add them to the background library.
🛠️ Technical Stack
- **Language**: C++20
- **UI Framework**: Dear ImGui
- **Audio Backend**: SDL2
- **SID Engine**: libsidplayfp (with ReSIDfpBuilder)
- **JSON Serialization**: Glaze
- **Logging**: Quill (asynchronous logging library)
## Technical Details
### Multi-engine Architecture
The player uses 3 parallel SID engines for voice isolation:
- Each engine analyzes one voice while muting the others
- Audio is manually mixed from the 3 engines
- All engines play synchronously, even when muted (for oscilloscope analysis)
### Dependencies
- **ImGui** - GUI framework (git submodule)
- **SDL2** - Window and audio backend
- **SDL2_image** - Image loading
- **libsidplayfp** - SID file playback engine
- **Glaze** - JSON serialization for metadata database
- **Quill** - Asynchronous logging library
## License
This project uses:
- **ImGui** : MIT License
- **SDL2** : zlib License
- **SDL2_image** : zlib License
- **libsidplayfp** : GPL v2+
- **Glaze** : MIT License
- **Quill** : MIT License