A music player assembled with https://tauri.app/

To limit crawling, anonymous browsing shows current files and the last 50 commits/diffs. Clone for full history.

  • Rust 56.8%
  • TypeScript 34.8%
  • Swift 7.2%
  • CSS 0.8%
  • HTML 0.2%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Vjeran Crnjak 2986d4d393
All checks were successful
Rust and Verus / rust (push) Successful in 2m47s
Rust and Verus / verus (push) Successful in 3s
Rust and Verus / frontend (push) Successful in 6m38s
fix(tests): Compare the empty cover response body explicitly
Clippy 1.99 rejects the emptiness assertion in the HTTP cover ownership
test. Compare against an empty byte string to show the body on failure
and avoid ambiguous element inference from an untyped empty array.

Co-authored-by: OpenAI Codex <codex@noreply.forgejo.crnjak.xyz>
2026-11-09 14:09:46 +01:00
.forgejo/workflows build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
benchmarks/results feat(covers): Share 64px previews through a persistent atlas 2026-10-27 14:21:19 +01:00
crates build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
docs refactor(effects): Flatten contracts and own frontend task lifetimes 2026-11-08 21:43:35 +01:00
plugins/tauri-plugin-nmrav-player fix(ios-player): Refresh Now Playing anchors for each loop 2026-10-30 14:50:43 +01:00
scripts fix(tooling): Recognize composition roots and resource cleanup 2026-11-09 11:01:56 +01:00
src refactor(effects): Flatten contracts and own frontend task lifetimes 2026-11-08 21:43:35 +01:00
src-tauri fix(tests): Compare the empty cover response body explicitly 2026-11-09 14:09:46 +01:00
tests fix(tooling): Recognize composition roots and resource cleanup 2026-11-09 11:01:56 +01:00
tools build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
vendor/wry build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
verification/scrobble ci(frontend): enforce TypeScript and browser checks 2026-10-01 15:49:35 +02:00
.gitignore build(typescript): typecheck the entire toolchain 2026-10-01 15:48:08 +02:00
.node-version build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
.prettierrc.json Unify domain types and enforce code style 2026-09-06 21:14:38 +02:00
.swiftformat Unify domain types and enforce code style 2026-09-06 21:14:38 +02:00
AGENTS.md refactor(effects): Flatten contracts and own frontend task lifetimes 2026-11-08 21:43:35 +01:00
BENCHMARKS.md perf(navigation): Use indexed grouping and cover lookups 2026-10-16 14:32:56 +02:00
index.html refactor(appearance): compile the theme bootstrap 2026-10-01 15:49:34 +02:00
knip.jsonc refactor(covers): Share the rendition request program 2026-10-26 12:18:14 +01:00
missing-cover.png Build fast M4A library indexer 2026-09-02 16:32:01 +02:00
missing-cover.svg Add native playback and compact library UI 2026-09-03 09:01:23 +02:00
package.json build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
playwright.config.ts test(browser): adopt Playwright and Rust GTK probes 2026-10-01 15:49:34 +02:00
pnpm-lock.yaml build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
pnpm-workspace.yaml build(fp-ts): compile pinned TypeScript source 2026-10-02 10:39:44 +02:00
README.md build(ios): Add shared debug and release schemes 2026-10-18 12:36:23 +02:00
TODO.md Align Linux playback reconciliation with shared Rust types 2026-09-30 19:58:27 +02:00
tsconfig.json build(deps): Upgrade the supported dependency stack 2026-11-03 11:34:44 +01:00
tsconfig.strict.json build(typescript): typecheck the entire toolchain 2026-10-01 15:48:08 +02:00
tsconfig.tooling.json build(typescript): typecheck the entire toolchain 2026-10-01 15:48:08 +02:00
vite.config.ts perf(frontend): Exclude CommonJS codecs from the browser bundle 2026-10-18 11:32:26 +02:00
vitest.config.ts test(suite): Reuse browser workers and trim repeated cases 2026-10-24 10:22:48 +02:00

nmrav

A music library and player for Linux and iOS, built with Tauri.

Features

  • Fast MP3 and M4A import with metadata and album artwork.
  • Custom playlists with bulk selection and track reordering.
  • Fast scrolling through large libraries.
  • iOS Now Playing widget and lock-screen playback controls.
  • Search across the library and within playlists.
  • Persisted scrobbling to Last.fm, Libre.fm, and ListenBrainz, with retries.
  • Verus-verified scrobble thresholds.
  • Verus-verified listening-time accounting.
  • Browse by artist, album, year, or decade, with configurable sorting.
  • Shuffle, repeat, and saved playback queues and positions.
  • Linux desktop media controls through MPRIS.

Building

Use Node 26.10.0 (.node-version), pnpm 11.26.0, and Rust 1.98.1.

pnpm install --frozen-lockfile

Linux

Install Tauri's Linux prerequisites, including GTK 3 and WebKitGTK 4.1, plus GStreamer 1.24+ development files and an AAC/M4A decoder. On Arch Linux, install the audio packages with:

sudo pacman -S --needed gstreamer gst-plugins-base gst-plugins-good gst-libav

Run in development:

pnpm tauri dev

Build and run a release executable:

pnpm tauri build --no-bundle
./src-tauri/target/release/nmrav

Choose Import folder to add music.

macOS icons

Run pnpm icons:macos to regenerate the macOS PNG and ICNS assets from missing-cover.svg. The generator adds a rounded tile, transparent margins, and a subtle shadow for the Dock. tauri.macos.conf.json selects these assets for macOS development and release builds. pnpm icons includes this step. The shared album placeholder and other platforms keep their own icon assets.

iOS

Requires macOS and Xcode.

Install the Rust device and Apple Silicon simulator targets and the LLVM tools used by the Swift bridge with Xcode 27:

rustup target add aarch64-apple-ios aarch64-apple-ios-sim
rustup component add llvm-tools

The Xcode project is already checked in. Open it through Tauri and keep the terminal process running while building in Xcode:

pnpm tauri ios dev --open --host

Choose an iPhone or simulator, set your signing team for a physical device, select a shared scheme, and press Cmd+R:

Scheme Build Run debugger
nmrav_iOS Debug Rust and Swift, full symbols LLDB
nmrav_iOS-ReleaseDebug Optimized Rust and Swift, full Rust symbols and dSYM LLDB
nmrav_iOS-Release Optimized Rust and Swift, stripped executable None

For bundled frontend assets and launch measurements, open Xcode with pnpm tauri ios build --open instead of the dev command above. Keep that terminal running; Tauri's Xcode build phase reads its build options from it. The selected scheme controls native optimization and debugger attachment; the opening command controls whether the frontend uses Vite or bundled assets. Release retains the existing Cargo optimizations (one codegen unit, thin LTO, abort on panic) and strips the final executable. ReleaseDebug disables Rust stripping and enables full debug information. Its separate dSYM increases build artifacts, not the installed Release app.

For a standalone release:

pnpm tauri ios build

Run pnpm check:apple on macOS to compile the iOS release library and all macOS targets. Portable Rust callbacks also compile in ordinary host tests. To verify the complete iOS link and archive without signing, run pnpm tauri ios build --ci --no-sign --archive-only.

Copy MP3 or M4A files into the app's Documents folder and choose Refresh Documents. See iOS playback status for known playback issues.