https://github.com/sixlive/mux
A CLI to manage audio input/ouput presets
https://github.com/sixlive/mux
Last synced: 6 days ago
JSON representation
A CLI to manage audio input/ouput presets
- Host: GitHub
- URL: https://github.com/sixlive/mux
- Owner: sixlive
- Created: 2026-05-07T18:31:33.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-18T13:56:46.000Z (16 days ago)
- Last Synced: 2026-05-18T15:35:59.817Z (16 days ago)
- Language: Go
- Homepage:
- Size: 28.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# mux
macOS audio preset manager — switch input/output devices and volumes with a single command.
## Install
Download a binary from the [releases page](https://github.com/sixlive/mux/releases).
### Build from source
Requires Go 1.26+ and macOS (CoreAudio).
```sh
go install github.com/sixlive/mux@latest
```
## Usage
Run `mux` with no arguments to launch the interactive preset picker with fuzzy search.
### Commands
```
mux Interactive preset picker
mux create Create a new preset (guided wizard)
mux apply NAME Apply a preset by name
mux edit NAME Edit an existing preset
mux delete NAME Delete a preset
mux list List all presets
mux devices List all audio devices
```
### Example
```sh
# Create a preset for your desk setup
mux create
# Switch to it later
mux apply desk-speakers
# Or pick interactively
mux
```
## Configuration
Presets are stored in `~/.config/mux/config.json`.
Each preset can configure:
- Output device and volume
- Input device and volume
Devices are matched by name, so presets survive USB reconnections that change device UIDs.
## License
MIT