.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "JACK_MIX_BOX" 1 "2021-04-14" "18" "audio"
.SH NAME
jack_mix_box \- A minimal JACK audio mixer with MIDI volume control
.SH SYNOPSIS
.sp
jack_mix_box [\-n <name>] [\-p] [\-s] [\-v <dB>] MIDI_CC...
.SH DESCRIPTION
.sp
This manual page documents the \fBjack_mix_box\fP command.
.sp
\fBjack_mix_box\fP is a minimal, GUI\-less version of \fBjack_mixer\fP\&. 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.
.SH OPTIONS
.sp
Positional arguments:
.INDENT 0.0
.INDENT 3.5
MIDI_CC...      add input channel controlled by MIDI_CC
.UNINDENT
.UNINDENT
.sp
Optional arguments:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
print this help message
.TP
.B  \-n\fP,\fB  \-\-name
set JACK client name
.TP
.B  \-p\fP,\fB  \-\-pickup
enable MIDI pickup mode (default: jump\-to\-value)
.TP
.B  \-s\fP,\fB  \-\-stereo
make all input channels stereo with left+right input
.TP
.B  \-v\fP,\fB  \-\-volume
initial volume gain in dBFS (default 0.0, i.e. unity gain)
.UNINDENT
.UNINDENT
.UNINDENT
.SH USAGE
.sp
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.
.sp
Use \fBjack_connect\fP or any other JACK conmection manager to connect other JACK
clients or system ports to the input and output port.
.sp
Send a \fBSIGUSR1\fP signal to the \fBjack_mix_box\fP process to have the current
volumes per input channel reported to the standard output.
.SS JACK AUDIO AND MIDI PORTS
.INDENT 0.0
.IP \(bu 2
For each input channel, \fBjack_mix_box\fP will create one (if it is a mono
channel) or two (stereo) JACK audio input ports. The input port(s) will be
named \(dqChannel <n>\(dq, where \(dq<n>\(dq is the channel number, and have an \(dq L\(dq
resp. \(dq R\(dq suffix, it the channel is stereo.
.IP \(bu 2
It will create two JACK audio output ports named \(dqMAIN L\(dq and \(dqMAIN R\(dq.
.IP \(bu 2
It will also create one JACK MIDI input (\(dqmidi in\(dq) and one MIDI output
(\(dqmidi out\(dq) port.
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.TP
.B \fBLANGUAGE\fP, \fBLC_ALL\fP, \fBLC_MESSAGES\fP, and \fBLANG\fP
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.
.TP
.B \fBLC_NUMERIC\fP
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 \fBLC_NUMERIC\fP is not set, its value is inherited
from one of the language environment variables described above.
.TP
.B \fBLOCALEDIR\fP
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 \fB<prefix>/share/locale\fP\&.
.UNINDENT
.SH SIGNALS
.INDENT 0.0
.TP
.B \fBSIGUSR1\fP
Send \fBSIGUSR1\fP to the \fBjack_mix_box\fP process to have the current
volumes reported per input channel.
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.IP \(bu 2
Project homepage (\fI\%https://rdio.space/jackmixer/\fP)
.IP \(bu 2
Source code repository on GitHub (\fI\%https://github.com/jack\-mixer/jack_mixer\fP)
.IP \(bu 2
JACK Audio Connection Kit (\fI\%https://jackaudio.org/\fP)
.UNINDENT
.SH AUTHOR
Nedko Arnaudov <nedko@arnaudov.name> (original author),
Frédéric Peters <fpeters@0d.be> (current maintainer).
.SH COPYRIGHT
GNU General Public License Version 2
.\" Generated by docutils manpage writer.
.