|
Rust CI fader_master passed its selected CI mode.
MadGobblins/fader_master/pipeline/head This commit looks good
Details
Open and reconcile configured MIDI outputs independently, send opt-in note or CC feedback from confirmed mute observations, deduplicate successful values, and resynchronize after reconnect. Enable green mute feedback in the APC MINI example and document the profile fields and mixed/offline policy. Tests: cargo fmt --all -- --check Tests: cargo check --workspace --all-targets --all-features --locked Tests: cargo test --workspace --all-targets --all-features --locked Tests: cargo test --workspace --doc --all-features --locked Tests: cargo clippy --workspace --all-targets --all-features --locked -- -D warnings Tests: cargo build --workspace --release --all-features --locked Tests: cargo check --workspace --locked Tests: cargo check --workspace --no-default-features --locked Tests: cargo check -p midi --no-default-features --features midir --locked Tests: cargo check -p volume_lib --no-default-features --features pulse --locked |
||
|---|---|---|
| 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
Control Linux application volume and mute from a USB MIDI controller. One fader can follow an application, a group of applications, or the default audio output, while the terminal UI remains useful as a complete software mixer.
The horizontal layout puts conventional bottom-up faders side by side. The same profile can switch to a compact stacked layout for narrow terminals:
Features
- Match PulseAudio or
pipewire-pulsestreams by application metadata, with exact and regular-expression capture rules. - Control individual applications, non-nesting application groups, and the default output without changing live audio during discovery.
- Learn volume and mute controls from MIDI, reflect confirmed mute state on control-surface LEDs, use pickup to prevent jumps, and keep independently identified controllers from colliding.
- Arrange faders and named separators directly in the mixer. Choose Slim, Standard, or Thick faders, and hide detail faders behind a group when useful.
- Use horizontal or vertical layouts and six built-in terminal themes.
- Run as one command, or keep a standalone server alive while reconnecting TUI clients come and go.
- Edit a validated draft from the TUI and persist it with one explicit Save. Malformed or conflicting edits never replace the active configuration.
Quick start
Install the platform dependencies described in the documentation index, then run the combined server and TUI with the sample PipeWire/Pulse profile:
cargo run --locked -p fader_master -- \
--config examples/profiles/arch-pipewire.toml --audio pulse
The combined executable connects to an existing per-user server when possible
and starts an embedded one otherwise. Running without --config creates a
safe empty default profile on first use, which can then be edited in the TUI.
Everyday controls
| Action | Vertical | Horizontal |
|---|---|---|
| Select | Up/Down or J/K | Left/Right or J/K |
| Change volume | Left/Right | Up/Down |
| Reorder | Shift+Up/Down or Shift+J/K | Shift+Left/Right or Shift+J/K |
| Toggle mute | M | M |
| Edit fader or separator | E | E |
| Add/remove separator | A / D | A / D |
| Hide selected fader | Shift+H | Shift+H |
| Help | h or ? | h or ? |
Use Tab to open Config, T to cycle the theme, and Q to open the quit
confirmation. Fader editing exposes capture rules, group membership, separate
controller/Learn/Unlearn actions for volume and mute, size, and visibility.
Documentation
The documentation index contains installation instructions, advanced configuration and process layouts, examples, troubleshooting notes, architecture, project status, and related projects.
License
See LICENSE.