Skip to content

Latest commit

Β 

History

5 Commits

Folders and files

Repository files navigation

Arima Player

Arima Player

Release Downloads License

Rust TypeScript Tauri React Vite Tailwind

Platform No Electron Portable


Why another player

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

Features

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

Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚  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.

Tech stack

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

Requirements

  • Windows 10 / 11, x64
  • WebView2 runtime β€” ships with modern Windows; on older builds install the WebView2 Runtime if the app opens a blank window

Download

Grab arima.exe from the latest release. No installer β€” drop it anywhere and run it.

Your music files are never moved or modified.

Keyboard shortcuts

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.

Where your data lives

%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.

Build from source

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 install
npm run tauri:dev          # dev build with hot reload
npm run tauri:build:exe    # portable release build

Output: src-tauri/target/release/arima-player.exe.

Release builds need the custom-protocol feature. npm run tauri:build:exe sets it for you; a bare cargo build --release does not, and will produce a binary that expects the dev server on :1420.

Roadmap

  • 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.

Contributing

No rules, no templates, no bureaucracy.

See CONTRIBUTING.md for the long version (it is four lines).

License

MIT β€” do whatever you want with it. See LICENSE.

Releases

Packages

Contributors

Languages