jack_mix_box(1)

📦
version 19 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 NAME 💖

jack_mix_box — a minimal JACK audio mixer with MIDI volume control 🎛️✨

✨ SYNOPSIS ✨

jack_mix_box [-n <name>] [-p] [-s] [-v <dB>] MIDI_CC...

🌸 DESCRIPTION 🌸

bestie, this manual page documents the jack_mix_box command, and honestly? it's giving "small but mighty". 💅

jack_mix_box is a minimal, GUI-less version of jack_mixer. no windows, no buttons to click, just vibes and ports. it creates a JACK client with stereo output ports and a fixed number of mono or stereo input ports. the number of input ports — and the MIDI Control Change message that controls the volume level of each one — gets set right there on the command line. the signal of each input channel is mixed into the stereo outputs. that's the whole main character arc. 👑

🎀 OPTIONS 🎀

Positional arguments:

  • MIDI_CC... — add an input channel controlled by MIDI_CC 🎚️

Optional arguments:

  • -h, --help — print this help message 🫶
  • -n, --name — set the JACK client name 🏷️
  • -p, --pickup — enable MIDI pickup mode (default: jump-to-value) 🙈
  • -s, --stereo — make all input channels stereo with left+right input 🌈
  • -v, --volume — initial volume gain in dBFS (default 0.0, i.e. unity gain) 🔊

🦋 USAGE 🦋

Each positional argument is interpreted as a MIDI Control Change number, and it adds a mixer channel with one (mono) or left+right (stereo) inputs, whose volume can be controlled via the given MIDI Control Change. one number in, one channel out, no cap. ✨

Use jack_connect or any other JACK connection manager to connect other JACK clients or system ports to the input and output port. that's your lil patch bay situation. 🔌

Send a SIGUSR1 signal to the jack_mix_box process to have the current volumes per input channel reported to the standard output. yes, it'll literally just tell you the tea. ☕

🎧 JACK AUDIO AND MIDI PORTS 🎧

  • For each input channel, jack_mix_box will create one (if it is a mono channel) or two (stereo) JACK audio input ports. The input port(s) will be named "Channel <n>", where "<n>" is the channel number, and have an " L" resp. " R" suffix, it the channel is stereo. 🫧
  • It will create two JACK audio output ports named "MAIN L" and "MAIN R". 👑👑
  • It will also create one JACK MIDI input ("midi in") and one MIDI output ("midi out") port. 💌

🌿 ENVIRONMENT 🌿

  • LANGUAGE, LC_ALL, LC_MESSAGES, and LANG — The first of these environment variables set to a non-empty value is used to determine the language(s) for loading gettext translation files. The value should be a colon separated list of language codes. 🌍
  • LC_NUMERIC — The language set via this environment determines the floating point number format used to parse volume levels given on the command line and to format them in the output. If LC_NUMERIC is not set, its value is inherited from one of the language environment variables described above. 🔢
  • LOCALEDIR — With this environment variable, the base directory for the gettext translation files can be changed from the default set at compile time, which is usually <prefix>/share/locale. 📁

⭐ SIGNALS ⭐

  • SIGUSR1 — Send SIGUSR1 to the jack_mix_box process to have the current volumes reported per input channel. 📢

🔥 SEE ALSO 🔥

💜 AUTHOR 💜

Nedko Arnaudov <nedko@arnaudov.name> (original author), Frédéric Peters <fpeters@0d.be> (current maintainer). absolute icons, fr fr. 🫶

GNU General Public License Version 2 📜

okay that's the whole page, you ate it, no notes. this was version 19, dated 2021-04-14, and yes, it's the jack_mix_box(1) manual — go mix something pretty bestie 💖✨🎀

📦 where this page comes from