Fast test implementation of a midi-fader based software
Go to file
Dandaedre 9464944634
Rust CI fader_master passed its selected CI mode.
MadGobblins/fader_master/pipeline/head This commit looks good Details
docs: showcase the TUI and centralize guides
Validation: regenerated deterministic SVG screenshots twice with identical output; xmllint --noout docs/images/*.svg; 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-features, midir, and pulse checks.
2026-10-15 23:19:22 +02:00
config feat: safely upgrade legacy profiles 2026-10-15 23:06:28 +02:00
core feat(M1.4): reserve stateful relative groups 2026-10-15 03:14:36 +02:00
docs docs: showcase the TUI and centralize guides 2026-10-15 23:19:22 +02:00
examples/profiles feat: persist themes with a single save action 2026-10-15 22:29:56 +02:00
fader_master feat: safely upgrade legacy profiles 2026-10-15 23:06:28 +02:00
midi feat(M5.3): own live MIDI surface connections 2026-10-15 02:37:30 +02:00
scripts ci: export native backend parameter 2026-10-15 19:44:04 +02:00
sound feat(M7.4): make runtime polling configurable 2026-10-15 03:54:10 +02:00
tui docs: showcase the TUI and centralize guides 2026-10-15 23:19:22 +02:00
.gitignore ci: establish implementation fallback baseline 2026-10-05 07:28:08 +02:00
AGENTS.md docs(M1): record verified domain milestone and M2 boundary 2026-10-05 08:20:15 +02:00
Cargo.lock feat(M7.1): activate server and diagnostic commands 2026-10-15 00:15:21 +02:00
Cargo.toml feat(M7.2): authenticate and bound local clients 2026-10-15 01:14:50 +02:00
Jenkinsfile ci: export native backend parameter 2026-10-15 19:44:04 +02:00
LICENSE
…
README.md docs: showcase the TUI and centralize guides 2026-10-15 23:19:22 +02:00
architecture.md fix: add reliable fader reorder keys 2026-10-15 23:13:18 +02:00
checklist.md docs: condense the M9 and M10 hardware checklist 2026-10-15 04:33:32 +02:00
rust-toolchain.toml build(M0.1): pin reproducible Rust foundation 2026-10-05 07:47:49 +02:00
task.md feat: edit group members in a popup 2026-10-15 23:10:15 +02:00

README.md

fader_master

Version Tests Coverage

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.

Horizontal mixer showing application, group, and output faders

The horizontal layout puts conventional bottom-up faders side by side. The same profile can switch to a compact stacked layout for narrow terminals:

Vertical mixer showing stacked faders and separators

Features

  • Match PulseAudio or pipewire-pulse streams 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, 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.