A terminal-based DJ mixer for live performance with TidalCycles. Built in Rust with ratatui, it provides real-time EQ, filtering, crossfading, and sample pads for mixing audio from MPV and SuperCollider.
| Dual-deck mixer | A-B channel faders, pan, 3-band EQ, LPF/HPF |
| Crossfader | mix different decks, cue-in Deck C with unique output (headphone/booth) |
| Microphone input | selectable device, gain, and mute toggle |
| Sample pads | 4x4 grid with sequencer, save/load configs |
| SuperCollider integration | custom SynthDefs for processing SuperCollider output |
| Vim navigation | hjkl throughout, multi-modal nav system |
| Rust | cargo package manager and Rust language compiler |
| Nerd Fonts | required for icons (rewind, fast-forward, etc.) |
| MPV | media playback with IPC socket support |
| SuperCollider (optional) | for TidalCycles integration |
cargo install termixerThis will take the latest release binary and install it to ~/.cargo/bin/termixer (same as cargo).
curl -sL https://raw.githubusercontent.com/l00sed/termixer/master/install.sh | bashgit clone https://github.com/l00sed/termixer.git
cd termixer
cargo install --path .cargo build # debug
cargo build --release # optimized with LTO# Auto-discover audio sources
cargo run
# Specify MPV sources explicitly
cargo run -- -s "Deck A" /tmp/mpv-a.sock -s "Deck B" /tmp/mpv-b.sock
# With music and samples directories
cargo run -- -m ~/Music -S ~/Samplesmpv --input-ipc-server=/tmp/mpv-music.sock music.mp3There's also an mpv wrapper script included that you can use to automatically enable the necessary flags just by setting the TM environment variable:
TM=1 mpv music.mp3Termixer should automatically install this wrapper script to ~/.local/bin/mpv. When TM=1, it will add the socket and pcm flags. Without it, mpv runs normally.
To manage your own mpv config and disable automatic seeding of ~/.config/mpv/scripts/ and ~/.config/mpv/mpv.conf, use export TM_NO_CONFIG=1 in your shell profile.
NOTE: Termixer uses the default SuperDirt samples installation directory by default. It's a great, free library to grab some starter samples.
macOS — ~/Library/Application Support/SuperCollider/downloaded-quarks/Dirt-Samples
Linux — ~/.local/share/SuperCollider/downloaded-quarks/Dirt-Samples
Pad and sequence configurations can be exported to .json files and imported later to restore all saved samples, pad settings, and sequences. The default save/load directory is ~/Documents.
- Change the sample directory with
termixer -S PATH. - Change the sequences/samples ("sessions") directory with
termixer -L PATH.
| Flag | Description |
|---|---|
-s, --source NAME SOCKET |
Add an audio source (MPV IPC socket) |
-m, --music-dir PATH |
Directory for audio file browser |
-S, --samples-dir PATH |
Directory for sample pad files |
-L, --session-dir PATH |
Directory for session save/load (default: ~/Documents) |
-d, --discover |
Auto-discover audio sources (default) |
-h, --help |
Show help |
| Key | Action |
|---|---|
Tab / h / l |
Switch between panes (Deck A, DJ, Deck B, Master) |
Enter |
Enter control select mode |
Esc |
Go back one level |
? |
Toggle help overlay |
q |
Quit |
| Key | Action |
|---|---|
j / k |
Navigate controls up/down |
h / l |
Adjust value / toggle EQ kill switch |
J / K |
Coarse adjustment (0.2) |
+ / - |
Fine adjustment (0.05) |
m / s |
Toggle mute / solo |
c |
Center pan or crossfader |
0 |
Reset control to default |
| Key | Action |
|---|---|
A |
Open source picker for Deck A |
B |
Open source picker for Deck B |
P |
Toggle sample pads mode |
Check changes and run the test suite before opening a pull request:
cargo check
cargo test
cargo clippy -- -D warningsRun Termixer with DEBUG=1 while developing behavior, state synchronization, or audio routing:
DEBUG=1 cargo runDebug mode enables the in-app debug pane and preserves diagnostic logging that is otherwise redirected to prevent stderr from corrupting the TUI. Clippy is run with warnings treated as errors to keep new code lint-clean.
MIT