Keep the footer focused on non-obvious actions, split Add/Edit/Delete labels, and move Home/End guidance into the detailed keyboard popup. 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 (all pass; real-daemon tests remain opt-in). |
||
|---|---|---|
| config | ||
| core | ||
| docs | ||
| examples/profiles | ||
| fader_master | ||
| midi | ||
| scripts | ||
| sound | ||
| tui | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGELOG.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| Cross.toml | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| architecture.md | ||
| checklist.md | ||
| release.sh | ||
| rust-release.toml | ||
| 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 bottom-up faders side by side, with dividers and flexible spacers between sections. Switch to Vertical in Config for stacked cards, including one-row Slim and Bordered slim faders:
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, separators, and empty spacers directly in the mixer. Choose Slim, Bordered slim, Standard, or Thick faders, and hide detail faders behind a group when useful.
- Size separators independently and choose Plain, Line, Double line, or Box. Fill separators share spare space; names are optional.
- Use horizontal or vertical layouts and six built-in terminal themes.
- Choose Detailed, Compact, Symbol, Color, or Hidden pickup feedback in Config. Hiding the indicator keeps pickup protection active.
- 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.
- Switch among valid managed profiles from a popup in the Config view; the default switch adopts live audio without writing saved volume state.
- Reset the active profile from Config after an explicit confirmation. The TUI
preserves the previous file as
<profile>.toml.reset.bakbefore installing and activating a safe Master-output profile.
Quick start
Install a prebuilt release (recommended)
With cargo-binstall installed, download the current release candidate without compiling:
cargo binstall --git https://proxy.dandaedre.com/gitea/MadGobblins/fader_master \
--version '=0.1.0-rc.1' --strategies crate-meta-data fader_master
fader_master
This installs the combined launcher plus fader_master_server and
fader_master_client. Ensure Cargo's binary directory (usually ~/.cargo/bin)
is on your PATH. No repository checkout or sample configuration is needed.
Prebuilt binaries currently target x86-64 GNU/Linux and require ALSA,
libpulse and libudev runtime libraries, plus PulseAudio or pipewire-pulse.
They are built with an Ubuntu 24.04-based image; older distributions are not
yet qualified. This is an RC, not a stable release.
Without cargo-binstall, download the archive containing all three executables
from the release page,
verify it against the accompanying SHA256SUMS, and extract the executables
into a directory on your PATH.
First launch
The combined executable connects to an existing per-user server when possible
and starts an embedded one otherwise. Running without --config creates
a default profile with a Master-output fader. A sole detected MIDI input is
adopted as the default controller; otherwise choose a detected input in Config,
add it, and Save. Edit the Master fader with E to learn volume and mute controls.
Build from source (alternative)
For development or systems without compatible prebuilt binaries, follow the build prerequisites. From a source checkout, run:
cargo run --locked -p fader_master
See advanced configuration for explicit profiles and separate server/client operation.
The screenshots use reproducible example state rendered by the actual TUI; they do not represent a live hardware session.
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.
Config → Active profile opens the profile switcher.
Config → Reset active profile provides an emergency return to safe defaults;
confirming it immediately saves and activates the reset and keeps a .reset.bak
copy beside the profile.
Separator editing offers an optional name, size, and decoration; an empty
name with Plain + Fill creates flexible blank space. Press Enter to accept
popup edits, then use Config → Save to persist the draft.
After updating the binaries, restart the server as well as the client. The combined launcher reuses an already-running server.
Documentation
The documentation index contains installation instructions, advanced configuration and process layouts, examples, troubleshooting notes, architecture, project status, and related projects.
License
See LICENSE.