Tests: cargo test --locked -p fader_master --all-targets --all-features Tests: cargo test --locked -p midi --all-targets --all-features Lint: cargo clippy --locked -p fader_master -p midi --all-targets --all-features -- -D warnings Smoke: APC MINI connected as backend 36:0 while PipeWire mixer remained ready |
||
|---|---|---|
| config | ||
| core | ||
| docs | ||
| examples/profiles | ||
| fader_master | ||
| midi | ||
| scripts | ||
| sound | ||
| tui | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| architecture.md | ||
| checklist.md | ||
| rust-toolchain.toml | ||
| task.md | ||
README.md
fader_master
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, checkpointing, and live
profile application/group aggregation are implemented; persistent MIDI
lifecycle, pickup/feedback, and the configuration editor remain on the ordered
backlog:
- Architecture and library research
- Implementation tasks and acceptance tests
- Project-agent instructions and test/commit workflow
- Build prerequisites and MSRV
- CI coverage and badge lifecycle
- Hands-on functional checklist
Run the live TUI
Start the server in one terminal:
cargo run --locked -p fader_master -- serve \
--config examples/profiles/arch-pipewire.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 configured application or group, Left/Right to
change its volume, M to toggle mute, and Q or Escape to quit. Offline objects
remain visible, and aggregate rows show MIXED when member state differs. See
the hands-on checklist for the exact milestone scope and restoration steps.