fader_master/README.md

3.6 KiB

fader_master

Version Tests Coverage

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:

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 profile's theme draft, 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 session theme. Save from Config to persist a theme selected with T. 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, and separate controller, Learn MIDI, and Unlearn MIDI actions for both volume and mute. Learning opens a waiting popup and captures the next supported fader movement or button press from the selected controller. The editor also provides per-fader Size (Slim, Standard, or Thick) and visibility. Slim faders occupy one terminal row; Standard remains the compatible default. The separator name is entered in a centered popup for both add and rename actions. The Config tab is a settings/status page: change the profile theme, switch the persisted mixer layout between Vertical and Horizontal, select the profile's default MIDI controller, restore individual hidden faders, inspect backend and MIDI-device state, and save the server-owned draft. Save both activates the validated configuration and persists it; there is no separate Apply step. Unassigned volume and mute controls inherit that default for MIDI learn. Horizontal mode packs fader cards side by side and keeps separators full-width. The old Shift+h hidden-list mode and pipe-delimited object editors are no longer used.

References