JACK_MIX_BOX(1)

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

This manual page documents the jack_mix_box command.

jack_mix_box is a minimal, GUI-less version of jack_mixer. 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 controlling the volume level of each is set via the command line. The signal of each input channel is mixed into the stereo outputs.

OPTIONS

Positional arguments:
        MIDI_CC... add input channel controlled by MIDI_CC

Optional arguments:

            -h, --help
                print this help message

            -n, --name
                set 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 adds a mixer channel with one (mono) or left+right (stereo) inputs, whose volume can be controlled via the given MIDI Control Change.

Use jack_connect or any other JACK conmection manager to connect other JACK clients or system ports to the input and output port.

Send a SIGUSR1 signal to the jack_mix_box process to have the current volumes per input channel reported to the standard output.

  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

    •   Project homepage ( <https://rdio.space/jackmixer/> )

    •   Source code repository on GitHub ( <https://github.com/jack-mixer/jack_mixer> )

    •   JACK Audio Connection Kit ( <https://jackaudio.org/> )

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

COPYRIGHT
GNU General Public License Version 2