furumi

Terminal client (TUI) for the furumusic server. Cross-platform: Linux, macOS, Windows.

Building

Rust 1.88+ (edition 2024).

cargo build --release      # binary: target/release/furumi

Linux

Sound output needs the system ALSA library — the one and only system build dependency (PipeWire/PulseAudio are reached through the ALSA compatibility layer at runtime):

# Debian/Ubuntu
sudo apt install libasound2-dev pkg-config
# Fedora
sudo dnf install alsa-lib-devel pkgconf-pkg-config
# Arch
sudo pacman -S alsa-lib pkgconf

Everything else is pure Rust: TLS is rustls, MPRIS media keys go through zbus (no libdbus), images and audio decoding are Rust crates.

macOS / Windows

No system packages required. (Windows: media keys are not wired up yet; playback works.)

Configuration

~/.config/furumi/keymap.toml — keybinding overrides, see src/config/default_keymap.toml for the format and defaults.
~/.config/furumi/credentials.json — created on login (0600).
Logs: in-app on the Logs tab (5), and in the cache dir (furumi-cli.log), filtered by RUST_LOG.