Repository navigation
Releases
v0.5.0
A cleaner, more consistent CoreAmp. This release rebuilds the entire interface on a single modern component system, so every screen shares one cohesive visual language, and adds a round of player and library improvements on top.
The interface
The front end is now a Vue 3 application built entirely on VibeUI.
- Every control, table, button, and panel is a VibeUI component, so spacing, color, and behavior stay consistent across the whole app.
- Player-first layout: the now-playing panel and queue sit up top with a fixed footprint, and the library never gets pushed around. Each pane scrolls its own content.
- A real library view: sortable, searchable, paginated track tables with segmented Tracks, Artists, Albums, and Genres, album-art grids, and inline actions (play next, add to queue, edit metadata, jump to artist or album).
- Light and dark themes with an in-app toggle, a slim global loading indicator, and clearer, dismissible error reporting.
Player and library
- 10-band graphic EQ with savable presets
- ReplayGain (track and album), crossfade, and gapless playback
- Smart shuffle, repeat modes, volume with mute, and a sleep timer
- 0 to 5 star ratings, full metadata editing, and manual album-artwork replacement
- Media keys and macOS Now Playing, a live tray now-playing label, and a built-in updater
- Faster library scanning and browsing with paginated track lists
Under the hood
A full code-review hardening pass: fixed memory leaks, tightened error handling and file-access scoping, unified timing logic, and switched track signal-detail reads to fast header parsing instead of decoding whole files.
Also new
Two optional games live inside the visualizer: Keyboard Hero, a casual rhythm mode that turns any track into a playable level, and Chicken Lander, a pixel-art lander with a music-reactive backdrop.
Install
- macOS: download
CoreAmp.app.zip(universal, signed), unzip, and move CoreAmp to Applications. - Linux: install the
.deb, or download the.AppImage, mark it executable, and run it.
v0.4.0
fix: add missing duration_secs field to test ScannedFile initializers
v0.3.2
Bug Fixes
- Fixed macOS 26 (Tahoe) crash on startup — App would bounce once and crash due to
objc2strict encoding checks panicking on changed ObjC method signatures. Enabledrelax-sign-encodingfeature to handle Apple's signed→unsigned type changes. (tao#1171)
Dependencies
- Added
objc2withrelax-sign-encodingfeature for macOS 26 compatibility.
Full Changelog: v0.3.1...v0.3.2
v0.3.1
Bug Fixes
- Fixed updater not producing signed bundles (added
createUpdaterArtifactsto config). - Fixed updater plugin registration to follow Tauri v2 pattern.
- Fixed GitHub Actions Node.js 20 deprecation warnings (upgraded to v5).
Dependencies
- Updated
rusqlite0.38 → 0.39. - Updated
wry0.54.2 → 0.54.3 (WebView engine — macOS compatibility). - Updated all transitive dependencies to latest versions.
v0.3.0
Auto-Updater
- Built-in auto-updater — App checks for updates on launch and from Settings panel.
- Download and install updates with one click; app restarts automatically.
- Signed update bundles verified with public key for security.
- "Updates" card in Settings shows current version and update status.
Games
- Arcade high scores — Top 5 leaderboard per game, stored in localStorage.
- High score list shown on game over (Astro Alien, Shapes) and song complete (Keys, Fishing).
- New high scores highlighted with "NEW!" marker.
- Astro Alien (renamed from Astro Chicken) — Space Invaders-style enemies, coins bounce and dance to bass, background pulses from black to neon on every beat.
- Guitar Hero Keys — Song complete screen with score, accuracy, and leaderboard.
- Neon Fishing — Song complete screen with score, fish caught, and leaderboard.
Packaging
- Universal macOS binary — Single app bundle runs on both Apple Silicon and Intel Macs.
- macOS compatibility extended to 10.13 (High Sierra) and up, including macOS 26 (Tahoe).
MACOSX_DEPLOYMENT_TARGET=10.13set in build scripts and CI.- CI workflow generates signed updater bundles and
latest.jsonfor auto-updates.
Technical
tauri-plugin-updateradded for OTA updates via GitHub Releases.serde_jsondependency added.- Updater permissions added to app capabilities.
- CSP updated to allow GitHub API and download connections.
CoreAmp 0.2!
Changelog
[0.2.0] - 2026-03-15
Games
- Astro Alien (mode 4) — Free-roaming platformer with a flying saucer character, flap mechanic, pits, platforms, coins, and full rave effects. Music drives scroll speed, enemy spawns, and visual intensity.
- Neon Fishing (mode 5) — Black Bass/Pokemon-inspired fishing with Wii-style on-screen instructions, 5 fish types, stamina/run mechanics, combo multiplier, and Tron-style perspective water grid.
- Hero Keys (mode 6) — 4-lane keyboard rhythm game (D/F/J/K). Notes follow chord progressions driven by bass hits, pulse and scale with audio energy. Perfect/Great/OK accuracy with combo multiplier.
- Shapes (mode 7) — Survive music-driven expanding rings, laser beams with safe gaps, bullet rain, and screen-wide waves. WASD to move, Space to dash. Difficulty ramps with survival time.
Visualizers
- Storm (mode 3) — Thundercloud reactive mode with procedural canvas textures, 55 clouds, 14 lightning bolts, constant ambient lightning, and bass-driven screen shake.
- Vortex (mode 1) and Nebula (mode 2) — Three.js reactive modes with music-driven particle systems and color cycling. Nebula animation speed increased 2.5x.
- Spectrum sub-modes powered by audioMotion-analyzer.
- 8 reactive modes total: Orb, Vortex, Nebula, Storm, Game, Fishing, Keys, Shapes.
- Visualizer mode and sub-mode selections persist in localStorage.
Library and Playlists
- Paginated loading — Tracks load in pages of 200 with "Load More" button.
- Queue persistence — Queue and current position saved to localStorage, restored on reload.
- Playlist deduplication — De-dup button per playlist. Tracks already present cannot be re-added.
- Search and filter by genre, artist/album/title, liked-only.
- Dashboard Home tab with artwork grid cards for top artists and recently played.
- Album art thumbnails in track rows with context menu.
- Save search results as playlist.
- Human-friendly import feedback messages.
UI/UX
- Consolidated library tabs from 10 to 6 (Home, Library, Liked, Playlists, Audio, Settings).
- Segmented control for Tracks/Artists/Albums/Genres within Library tab.
- Artwork grid cards for Artists, Albums, and Genres browsing.
- Settings panel redesigned with card-based grid layout (Import, Appearance, Library, Data).
- Theme toggle moved to Settings panel.
- Tab buttons inline with Library heading.
- Signal details (format, bitrate) inline with track title.
- Like button is now just the heart icon (28px, no wrapper).
- Player height reduced by 90px.
- Library panel min-height doubled to 960px.
- Page scrolls naturally so library is fully accessible below the player.
Technical
- audioMotion-analyzer replaces old EQ visualizer.
- Three.js r169 for 3D reactive modes.
imagecrate added for embedded album art extraction.- Devtools removed from default build (
--features devtoolsfor development). - Snap packaging removed.
Bug Fixes
- Fixed
bassVelocityundefined in Storm visualizer causing no lightning. - Fixed spectrum not reinitializing after audio graph setup.
- Fixed library not filling viewport height.
- Fixed CSP blocking tracks and IPC.
- Unknown titles now sort under "U" section.
v0.1.0
Announcing CoreAmp v0.1.0: The Purist Media Player for Linux and Mac
Today marks the first release of CoreAmp, a media player built for users who prioritize local music libraries and system performance. CoreAmp is designed to be lighter and more intelligent than standard cross platform players by focusing exclusively on Linux and macOS architectures.
The Philosophy
CoreAmp is built for the music purist. By excluding Windows compatibility layers and proprietary blobs, we have created a player with a minimal footprint and a high performance audio path. Built using Rust and Tauri V2, it offers a native feel with modern internal logic.
Key Features
- The Meta Daemon: A background service that enriches your library by fixing ID3 tags and fetching high resolution cover art via MusicBrainz.
- Flux Visualization Engine: A GPU accelerated visualizer inspired by MilkDrop. It utilizes WebGPU and custom shaders to generate fluid, audio reactive art.
- Native Audio Stack: CoreAmp uses FFmpeg and libplacebo for decoding. It interfaces directly with ALSA or PipeWire on Linux and CoreAudio on macOS.
- Simple Playlist Management: Playlists are stored in the portable M3U format. You can create, add to, and reorder playlists with standard drag and drop functionality.
Licensing and Source
CoreAmp is a source available project. It is licensed under the Polyform Noncommercial 1.0.0 license. This means it is free for personal and community use while preserving the integrity of the project for the noncommercial ecosystem.
Project Stack
- Language: Rust
- UI Framework: Tauri V2
- Database: SQLite
- Graphics: WebGPU
Get Started
You can access the source code and installation instructions on the official GitHub repository.
View the project at: https://github.com/velkymx/CoreAmp
Music on your machine. Owned by you.

