.\" 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_MIXER" 1 "2021-04-14" "18" "audio" .SH NAME jack_mixer \- A graphical multi-channel audio mixer for JACK .SH SYNOPSIS .sp jack_mixer.py [\-h] [\-c FILE] [\-d] [NAME] .SH DESCRIPTION .sp This manual page documents the \fBjack_mixer\fP command. .sp \fBjack_mixer\fP is a multi\-channel audio mixer application for the JACK Audio Connection Kit with a graphical user interface and has a look & handling similar to hardware mixing desks. .SH OPTIONS .sp Positional arguments: .INDENT 0.0 .INDENT 3.5 NAME set JACK client name .UNINDENT .UNINDENT .sp Optional arguments: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .TP .B \-h\fP,\fB \-\-help show this help message and exit .TP .BI \-c \ FILE\fR,\fB \ \-\-config \ FILE load mixer project configuration from FILE .TP .B \-d\fP,\fB \-\-debug enable debug logging messages .UNINDENT .UNINDENT .UNINDENT .SH GUI USAGE .sp After starting \fBjack_mixer\fP, you need to create at least one input and one output channel via the respective entries in the \(dqMixer\(dq menu (see section \fBMAIN MENU\fP). .sp Then connect your audio sources to the \fBjack_mixer\(aqs\fP JACK audio input ports (see section \fBJACK AUDIO AND MIDI PORTS\fP) using \fBjack_connect\fP or GUI tools like the QJackCtl\(aqs connections window, Catia, Carla, etc. Connect the monitor channel output port(s) or the output ports of the output channels to the input ports of your audio interface or any other JACK audio input ports. .sp Then adjust input and output channel volume levels and balance as required using the fader controls in each channel strip (see section \fBMOUSE BINDINGS\fP for ways to to control the faders and routing). .SS JACK AUDIO AND MIDI PORTS .INDENT 0.0 .IP \(bu 2 For each input channel, \fBjack_mixer\fP will create one (if it is a mono channel) or two (stereo) JACK audio input ports. The input port(s) will be named like the input channel strip, if it is a mono channel, or with an \(dq L\(dq resp. \(dq R\(dq suffix, it it is a stereo channel. .IP \(bu 2 Optionally, for each input channel, it creates a direct, post\-fader audio output port (mono) or pair of output ports (stereo). These are named the same as their input port(s) with \(dq Out\(dq resp. \(dq Out L\(dq / \(dqOut R\(dq appended. .IP \(bu 2 For each ouput channel it will create one (mono) or two (stereo) audio output ports. .IP \(bu 2 Additionally it will create one pair of audio monitor ports named \(dqMonitor L\(dq and \(dqMonitor R\(dq. .IP \(bu 2 If \fBjack_mixer\fP was compiled with JACK MIDI support, it will also create one MIDI input (\(dqmidi in\(dq) and one MIDI output (\(dqmidi out\(dq) port. .UNINDENT .SS MAIN MENU .sp Main Menu: .sp Use the \fBMixer\fP menu to: .INDENT 0.0 .IP \(bu 2 Add an input or output channel. .IP \(bu 2 Add an output channel. .IP \(bu 2 Open a file with a preset mixer layout. .IP \(bu 2 Save the current mixer layout to an XML file. .IP \(bu 2 Exit \fBjack_mixer\fP\&. .UNINDENT .sp Use the \fBEdit\fP menu to: .INDENT 0.0 .IP \(bu 2 Change the properties of an input or output channel. .IP \(bu 2 Remove an input or output channel. .IP \(bu 2 Toggle all channel strips between wide and narrow view. .IP \(bu 2 Clear the current mixer layout, i.e. remove all input and output channels. .IP \(bu 2 Open the setting preferences dialog. .UNINDENT .sp Use the \fBHelp\fP menu to show \fBjack_mixer\(aqs\fP about dialog. .SS MOUSE BINDINGS .sp Main window: .INDENT 0.0 .IP \(bu 2 Left\-click and drag the vertical divider line horizontally to set the size distribution of the left and right panels for the input and output channel strips. If a panel contains more channel strips than can be fit into its horizontal size, horizontal scrollbars will be available at the bottom of the panel. .UNINDENT .sp Channel strip header: .INDENT 0.0 .IP \(bu 2 Double click the channel strip header to open the channel properties dialog. .IP \(bu 2 Ctrl+left\-click the channel strip header to toggle the channel strip between wide and narrow view. .IP \(bu 2 Left\-click and drag the channel strip header horizontally to re\-order channel strips. This doesn\(aqt effect the order of the JACK output ports and input channels are always arranged on the left side of the main \fBjack_mixer\fP window and output chanels on the right side. .UNINDENT .sp Control groups (input channels): .sp Each input channel header has a control group for each output channel, which has the same background color and label as the corresponding output channel header. .sp Each output channel control group shows a pre/post\-fader (\(dqP\(dq) and a mute (\(dqM\(dq) button and, optionally, a solo (\(dqS\(dq) button. .INDENT 0.0 .IP \(bu 2 Left\-click the pre/post\-fader (\(dqP\(dq) button to toggle the signal sent to the corresponding output channel between the post\-fader (off) and pre\-fader (on) signal of the input channel. .IP \(bu 2 Left\-click the mono (\(dqM\(dq) button to mute the signal from the input channel going to the corresponding output channel. .IP \(bu 2 Left\-click the solo (\(dqS\(dq) button to solo the input channel for the corresponding output channel. i.e. only the signal from this input channel (plus any other soloed channels) is going to this output channel. .UNINDENT .sp Volume read\-out and peak\-indicator: .INDENT 0.0 .IP \(bu 2 Left\-click the volume level read\-out to enter a value manually and press Enter to set it. .IP \(bu 2 Left/right\-click the peak volume level read\-out to reset the over\-zero indication. .IP \(bu 2 Middle\-click the peak volume level read\-out to set the volume level to peak at 0 dB at the current signal input level. .UNINDENT .sp Volume meter: .INDENT 0.0 .IP \(bu 2 Left\-click the pre\-fader (\(dqPRE\(dq) button below the volume meter to switch the signal, which is metered, from post\-fader (off) to pre\-fader (on). .sp \fI(not yet implemented)\fP .UNINDENT .sp Volume slider: .INDENT 0.0 .IP \(bu 2 Left\-click and drag vertically anywhere in the slider area to set the channel output volume level. .IP \(bu 2 Scroll the mouse wheel up or down over the slider area to increase or decrease the volume level. .IP \(bu 2 Right\-click anywhere in the slider area to move the volume level slowly towards the click position. .IP \(bu 2 Double click to set the volume level to \-inf. .IP \(bu 2 Ctrl+left\-click to set the volume level to 0 dBFS. .UNINDENT .sp Balance slider: .INDENT 0.0 .IP \(bu 2 Left\-click and drag horizontally anywhere in the slider area to set the balance between the left and right channel of the output signal. .IP \(bu 2 Scroll the mouse wheel up or down over the slider area to move the balance to right or left. .IP \(bu 2 Right\-click anywhere in the slider area to move the balance slowly towards the click position. .IP \(bu 2 Double click to set the left/right balance to center. .UNINDENT .sp Channel buttons: .INDENT 0.0 .IP \(bu 2 Left\-click the mono (\(dqM\(dq) button to mute signal from channel going to all output channels (including direct channel outs). .IP \(bu 2 Ctrl+left\-click the mono (\(dqM\(dq) button for \(dqexclusive\(dq mute, i.e. the mute function will be activated on this input or output channel only and deactivated on all other input resp. output channels. .IP \(bu 2 Left\-click the solo (\(dqS\(dq) button to solo an input channel, i.e. only the signal from this channel is going to all output channels (including the direct outputs of the channel). .sp The solo function is cumulative, i.e. you can activate solo on more than one input channel and the signals from all soloed channels will be going to each output channel. .sp Output channels have no solo button. .IP \(bu 2 Ctrl+left\-click the solo (\(dqSM\(dq) button for \(dqexclusive\(dq solo, i.e. the solo function will be activated on this channel only and deactivated on all other input channels. .IP \(bu 2 Right\-clicking the mute (\(dqM\(dq) button acts like left\-clicking but also synchronizes the muted state on all output channel control groups of the channel with the main channel mute button. .sp Output channel control groups, where the mute function was already active before righ\-clicking the mute button are unaffected, i.e. it will stay activated. .IP \(bu 2 Right\-clicking the solo (\(dqS\(dq) button acts like left\-clicking but also synchronizes the soloed state on all output channel control groups of the channel with the main channel solo button. .sp Output channel control groups, where the solo function was already active before righ\-clicking the solo button are unaffected, i.e. it will stay activated. .IP \(bu 2 Left\-click the monitor (\(dqMON\(dq) button, to toggle monitoring. If monitoring is on, the (post\-fader) signal from the channel is sent to the \(dqMonitor L/R\(dq outputs. The monitor function is exclusive, i.e. activating monitoring on a channel, will turn off monitoring on any other channel. .UNINDENT .SH COMPATIBILITY .sp \fBjack_mixer\fP is fully compatible with the New Session Manager (NSM) protocol and provides Level 1 (L1) support for the LADISH protocol. When running as an NSM client, the mixer layout and current state will be saved in the NSM session. When started as an L1 client by LADISH, the mixer layout and current state will be saved in the LADISH studio session or project (the first time LADISH requests \fBjack_mixer\fP to save a project, it will open a \(dqSave as\(dq dialog). .SH FILES .INDENT 0.0 .TP .B \fB/jack_mixer/preferences.ini\fP This file stores global settings for \fBjack_mixer\fP\&. .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 if the language is not set in the global settings. The value should be a colon separated list of language codes. .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/share/locale\fP\&. .TP .B \fBJACK_MIXER_DEBUG\fP When this environment variable is set, the logging level in the Python layer is set to \fBDEBUG\fP unless it is overwritten by the \fB\-d|\-\-debug\fP command line switch. .TP .B \fBNSM_URL\fP When this environment variable is set, \fBjack_mixer\fP will act as a New Session Manager (NSM) session client. .UNINDENT .SH SIGNALS .INDENT 0.0 .TP .B \fBSIGUSR1\fP In accordance with Level 1 support of LADISH, \fBjack_mixer\fP saves the current mixer layout and state on receiving a \fBUSR1\fP signal. .TP .B \fBSIGINT | SIGTERM\fP When receiving an \fBINT\fP or \fBTERM\fP signal, \fBjack_mixer\fP will either exit the application immediately or, if enabled in the preferences, will show a confirmation dialog, allowing the user to either quit or cancel the action. .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) .IP \(bu 2 New Session Manager (\fI\%https://new\-session\-manager.jackaudio.org/\fP) .UNINDENT .SH AUTHOR Nedko Arnaudov (original author), Frédéric Peters (current maintainer). .SH COPYRIGHT GNU General Public License Version 2 .\" Generated by docutils manpage writer. .