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%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
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> |
||
| .forgejo/workflows | ||
| benchmarks/results | ||
| crates | ||
| docs | ||
| plugins/tauri-plugin-nmrav-player | ||
| scripts | ||
| src | ||
| src-tauri | ||
| tests | ||
| tools | ||
| vendor/wry | ||
| verification/scrobble | ||
| .gitignore | ||
| .node-version | ||
| .prettierrc.json | ||
| .swiftformat | ||
| AGENTS.md | ||
| BENCHMARKS.md | ||
| index.html | ||
| knip.jsonc | ||
| missing-cover.png | ||
| missing-cover.svg | ||
| package.json | ||
| playwright.config.ts | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| TODO.md | ||
| tsconfig.json | ||
| tsconfig.strict.json | ||
| tsconfig.tooling.json | ||
| vite.config.ts | ||
| vitest.config.ts | ||
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.