fader_master/README.md

1.9 KiB

fader_master

Version Tests Coverage

Linux application volume and mute control from one or more USB MIDI surfaces.

This repository contains tested domain and configuration libraries, a PulseAudio protocol worker compatible with pipewire-pulse, a local per-user server, and a live terminal mixer. The domain layer supports matching, routing, balanced group volume plans, and mute intent. Atomic TOML persistence and checkpointing are implemented; profile aggregation, persistent MIDI lifecycle, and the configuration editor remain on the ordered backlog:

Run the live TUI

Start the server in one terminal:

cargo run --locked -p fader_master -- serve \
  --config examples/profiles/desktop.toml --audio pulse

Then start the client in another:

cargo run --locked -p fader_master -- tui

Use Up/Down or J/K to select a live playback stream, Left/Right to change its volume, M to toggle mute, and Q or Escape to quit. See the hands-on checklist for the exact milestone scope and restoration steps. The current view lists raw application streams; configured application/group aggregation follows in M8.1.

References