termixer

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.

Features

Prerequisites

Installation

From crates.io

cargo install termixer

From GitHub release archive

This 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 | bash

From source

git clone https://github.com/l00sed/termixer.git
cd termixer
cargo install --path .

Build

cargo build              # debug
cargo build --release    # optimized with LTO

Usage

# 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 ~/Samples

Starting MPV with IPC

mpv --input-ipc-server=/tmp/mpv-music.sock music.mp3

There'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.mp3

Termixer 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.

Pads/Samples/Sequences

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.

CLI Options

Keyboard Controls

Navigation

Controls

Source & Sample Pads

Synth

For some great synth samples, I recommend downloading legowelt's sample packages.

The SYNTH tab row creates up to eight simultaneous synth tracks. Each track has an independent waterfall length, mute state, BPM, sample, and sample configuration. The SYNTH control-row play/pause toggles every synth, while master play/pause pauses all decks, sequences, and synths and resumes only those that were active. Synth presets save every tab and restore the complete pane from one synth.json; legacy single-synth presets remain loadable.

Development

Check changes and run the test suite before opening a pull request:

cargo check
cargo test
cargo clippy -- -D warnings

Run Termixer with DEBUG=1 while developing behavior, state synchronization, or audio routing:

DEBUG=1 cargo run

Debug 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.

License

MIT