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

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

# Ubuntu/Debian
sudo apt-get install -y build-essential cmake libsdl2-dev libsdl2-image-dev libsidplayfp-dev pkg-config

Build

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