Most desktop players are a browser with a skin: a 150 MB Chromium payload, a
framework runtime, and audio decoded through an <audio> element that was never
designed for sample-accurate work.
Arima Player splits the job at the right seam β Rust owns the audio path, the web layer owns only the pixels:
- Audio is decoded and rendered by a native Rust engine (
rodio), not by the WebView - The window is thin: WebView2, already present on modern Windows
- One portable
.exe, ~17 MB, no installer, no runtime to babysit - SQLite library stored next to your data, not in a hidden app container
Audio engine
- Plays local files β
mp3,flac,opus,wav,m4a,aacβ through the native engine - 10-band equalizer with presets, built on cascaded biquad filters
- Gain up to 200% with a lookahead limiter, so pushing volume does not turn into clipping
- FFT visualizer driven by the actual audio stream, not a decorative fake
Library
- Local SQLite library: fast scans, no cloud, no accounts
- Smart folders: liked, frequently played, recently played
- Global search across the whole library
- Custom sort order per folder
- Context menu on any track
Interface
- Glass UI with a custom background image
- Frameless window with a custom title bar
- Queue, now-playing panel, toasts
- Global search and per-folder view state
System
- Tray icon with a playback menu, owned by Rust so it keeps working when the window is hidden
- Global media hotkeys, plus a window-scoped keyboard fallback
- Fully portable β move the
.exe, keep your library
ββββββββββββββββββββββββββββββββββββββββ
β React 19 + TypeScript 7 β interface, state, layout
βββββββββββββββββββ¬βββββββββββββββββββββ
β Tauri IPC β commands down, events up
βββββββββββββββββββΌβββββββββββββββββββββ
β Rust core (src-tauri/src) β
β β
β audio.rs rodio output sink β
β dsp.rs biquad EQ + limiter β
β spectrum.rs rustfft FFT frames β
β db.rs rusqlite library β
β library.rs scanning, smart sets β
β tray.rs tray menu β
β shortcuts.rs global hotkeys β
ββββββββββββββββββββββββββββββββββββββββ
The audio thread never blocks on the UI: spectrum frames and playback state travel to the frontend over a channel, and the frontend only reads them.
| Layer | Crate | Role |
|---|---|---|
| Playback | rodio 0.23 |
decoding and device output |
| Metadata | lofty 0.25 |
tags, duration, embedded covers |
| Equalizer | biquad 0.6 |
10-band filter bank |
| Spectrum | rustfft 6.4 |
FFT for the visualizer |
| Storage | rusqlite 0.40 |
bundled SQLite, no system dependency |
| Glass | window-vibrancy 0.8 |
acrylic / mica backdrop |
| Threading | crossbeam-channel 0.5 |
audio β UI messaging |
| Shell | tauri 2.12 |
IPC, tray, window, single binary |
| Covers | image 0.25 |
art decoding and caching |
| Frontend | React 19, TypeScript 7 | UI |
| Build | Vite 8, Tailwind CSS 4 | bundling, styling |
- Windows 10 / 11, x64
- WebView2 runtime β ships with modern Windows; on older builds install the WebView2 Runtime if the app opens a blank window
Grab arima.exe from the latest release. No
installer β drop it anywhere and run it.
Your music files are never moved or modified.
Global (work while another app has focus):
| Shortcut | Action |
|---|---|
Media Play/Pause |
Play / pause |
Media Next / Media Previous |
Next / previous track |
Media Stop |
Stop |
Ctrl + Alt + Space |
Play / pause |
Ctrl + Alt + β / Ctrl + Alt + β |
Next / previous track |
Window-scoped (only while the player is focused):
| Shortcut | Action |
|---|---|
Space |
Play / pause |
β / β |
Next / previous track |
Bare Space and arrows are deliberately not grabbed system-wide β a background
player that eats the spacebar everywhere is hostile.
%APPDATA%\com.arima.player\library.db library database
%APPDATA%\com.arima.player\covers\ album art cache
%APPDATA%\com.arima.player\background.jpg custom background
Delete that folder to reset everything. Your music files stay untouched.
Requirements: Rust 1.90+, Node 20+, and Visual Studio Build Tools with the C++ desktop workload.
git clone https://github.com/arimaML/arima-player.git
cd arima-player
npm installnpm run tauri:dev # dev build with hot reload
npm run tauri:build:exe # portable release buildOutput: src-tauri/target/release/arima-player.exe.
Release builds need the
custom-protocolfeature.npm run tauri:build:exesets it for you; a barecargo build --releasedoes not, and will produce a binary that expects the dev server on:1420.
- Native Rust audio engine, 10-band EQ, lookahead limiter
- FFT visualizer, library, smart folders, search
- Glass UI, tray, global hotkeys, portable build β 1.0.0
- YouTube streaming
- SoundCloud streaming
Streaming sources are planned but not implemented. Something missing that you want? Start a Discussion.
No rules, no templates, no bureaucracy.
- Found a bug β open an Issue
- Got an idea β start a Discussion
- Made an EQ preset or fixed a typo β send a PR
See CONTRIBUTING.md for the long version (it is four lines).
MIT β do whatever you want with it. See LICENSE.
