Desktop

Maneki ships two native desktop wrappers around a generic Subsonic client UI: a Tauri build (Rust + native WebKit on macOS) and an Electron build (bundled Chromium). Both are first-class — pick the one whose trade-offs you prefer.

Aspect	Tauri	Electron
Binary size	~15 MB	~120 MB
Memory at idle	~80 MB	~250 MB
Renderer	OS WebView	Chromium
CSS / JS quirks	WebKit-only	Chrome-only
Update path	Self-contained	Self-contained

What it is

Both wrappers point the embedded webview at any Subsonic-compatible server — your own maneki serve, Navidrome, Airsonic, whatever. They're not just thin chrome around the web UI; the SPA inside (desktop/react/) is a full client: salted-token auth, refresh-restore via URL hashes, and a Web Audio FFT visualizer.

You log in once with URL + Username + Password; the app computes the Subsonic salted token and re-uses it across browse / play calls.

Install

Download a prebuilt build from the latest release. Each tag publishes installers for every platform:

Platform	Tauri (recommended)	Electron
macOS (Apple Silicon)	Maneki_X.Y.Z_aarch64.dmg — signed + notarized, opens clean	Maneki-Electron-X.Y.Z-arm64.dmg
Linux	.deb / .rpm / .AppImage	.AppImage / .deb
Windows	.msi / _x64-setup.exe	.exe

The macOS Tauri .dmg is the only signed + notarized build — it's the recommended pick on a Mac and opens with no Gatekeeper warning. The Linux and Windows Tauri builds and all Electron builds ship unsigned and untested; on first launch you'll need to get past Gatekeeper / SmartScreen (on macOS: right-click the app → Open).

Build from source

Alternatively, build locally:

git clone https://github.com/winterop-com/maneki.git
cd maneki
make build                    # all three (Python wheel + Tauri + Electron) -> ./dist/
# OR one wrapper at a time:
make desktop-tauri-build      # ~5 min on Apple Silicon — produces .app + .dmg
make desktop-electron-build   # ~3 min — produces .dmg

make build collects everything into a single ./dist/ directory at the repo root:

dist/
  maneki-X.Y.Z-py3-none-any.whl
  maneki-X.Y.Z.tar.gz
  Maneki-Tauri-X.Y.Z-aarch64.dmg
  Maneki-Tauri.app
  Maneki-Electron-X.Y.Z-arm64.dmg

Drag a .dmg into your Finder or double-click the .app directly.

Connecting

1. Launch the app — you get a login screen.
2. Server URL: http://<host>:8765 (or whatever your Subsonic-compatible server runs on). No /rest suffix.
3. Username + password: same credentials as maneki serve's config.
4. The app connects, fetches the artist list, and remembers the credentials in OS-encrypted storage (Keychain on macOS, libsecret on Linux, Credential Manager on Windows).

Window size

Resize the window to whatever you like — it's persisted across launches. Both wrappers write a small bounds file alongside their existing servers / session stores (Tauri: window.json in app_data_dir; Electron: maneki-window.json in the same userData folder). Saves are skipped while minimized or fullscreen and below the configured 720x480 minimum, so a transient sub-min Resized event on macOS can't wedge the next launch at a tiny window. To reset to the 1440x900 default, delete that file.

Refresh-restore

The app encodes the current artist / album / track in the URL hash:

http://localhost:1420/#a=1234&l=4567&t=8901

Reload the window (Cmd-R / F5) and you land back on the same track — useful when iterating on desktop/react/ during development.

Building from source

Pick a wrapper, then run the matching make target. Both load the same SPA from desktop/react/, so changes propagate to both.

make desktop-tauri-dev          # Tauri dev shell — hot reload of the SPA
make desktop-tauri-build        # Release Tauri bundle (.dmg + .app)
make desktop-electron-dev       # Electron dev shell
make desktop-electron-build     # Release Electron build
make build                      # Both, plus the Python wheel

The React frontend at desktop/react/ is plain HTML + JSX + CSS loaded via Babel-standalone — no build step. Edit any file there and reload the wrapper's window to pick up changes.

Trade-offs vs. the browser

The browser at http://<host>:8765/ does most of the same things — why use the desktop apps? Three reasons:

1. No tab. A standalone window with the visualizer running in the background, no risk of accidentally closing it.
2. Media keys. macOS Now Playing + global play/pause keys (the browser version's keymap is hijacked by your active tab).
3. Persistent credentials. Encrypted at the OS layer, not browser localStorage.

If none of those matter, the browser is fine.