Persist slim, standard, and thick mixer densities and expose them through the guided fader editor. Render slim faders on one line and make mixer scrolling account for variable row heights. Tests: cargo fmt --all -- --check; cargo check --workspace --all-targets --all-features; cargo test --workspace --all-targets --all-features; cargo test --workspace --doc --all-features; cargo clippy --workspace --all-targets --all-features -- -D warnings; cargo build --workspace --release --all-features; default/no-default/backend feature checks. |
||
|---|---|---|
| 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 fader or separator, Left/Right to
change its volume, M to toggle mute, T to cycle the built-in themes, and Q to
open the quit confirmation. Escape cancels the active editor or dialog and
does not quit from the main screen. Pass --theme dracula, nord,
gruvbox-dark, catppuccin-mocha, or solarized-dark to choose an initial
theme. 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.
The mixer is also the primary configuration surface. Shift+Up/Down reorders the
selected fader or separator; A adds a separator; E edits a selected fader or
separator; D removes a selected separator; and h hides a fader. Fader editing
provides capture Field/Exact-or-Regex/Pattern controls, group membership and
mode, separate Volume and Mute Learn/Unset actions, per-fader Size (Slim,
Standard, or Thick), and visibility. Slim faders occupy one terminal row;
Standard remains the compatible default. The Config tab is a settings/status
page: change the session theme, restore individual hidden faders, inspect
backend and MIDI-device state, and apply or save the server-owned draft. The
old Shift+h hidden-list mode and pipe-delimited object editors are no longer
used.