5 ## Version 15.1 (2021-03-15)
11 * In fixing issue #81 a regression was introduced in version 15, which caused
12 channel volume levels to not be restored when loading a project XML file.
14 * The `Channel.autoset_*_midi_cc` methods in the Cython extension module didn't
15 return the int result from the C functions they call, causing mis-leading
19 Project infrastructure and internals:
21 * A [wiki] was added to the `jack_mixer` GitHub project and a page with
22 instructions on how to install from source on debian / Ubuntu.
24 * The dependencies for building a Python wheel via `pip` were updated.
26 * When building from a Git checkout, the `cython` program is also found when it
27 is installed as `cython3`.
29 * Debug logging can be enabled by setting the `JACK_MIXER_DEBUG` environment
30 variable (for when the `-d` command line switch can't be used, e.g. when run
33 This release was created by Christopher Arndt.
36 [wiki]: https://github.com/jack-mixer/jack_mixer/wiki
39 ## Version 15 (2021-02-25)
41 **Important change:** `jack_mixer` now uses [meson] for building and
42 installation. See [INSTALL.md] for new build instructions.
47 * A global setting for default project file path was added and can be changed
48 in the preference dialog.
50 The default value is `$XDG_DATA_HOME/jack_mixer` (which is normally
51 `~/.local/share/jack_mixer`).
53 * A "Recent projects" menu was added, to allow loading recently used / saved
54 projects more quickly.
56 * Direct channel output ports are now optional and can be enabled/disabled in
57 the channel preferences dialog.
59 * Ctrl+left-click on the mute ("M") or solo ("S") channel buttons now activates
60 exclusive mute resp. solo.
62 * A man page for `jack_mixer` was added.
64 * `jack_mix_box` now supports the `-p|--pickup` command line option to enable
65 MIDI pickup mode, to prevent sudden volume or balance value jumps.
70 * Activating the solo function on an input channel could cause its
71 output signal be sent to the monitor outputs instead of the signal
72 from the channel, which had monitoring activated.
74 * Volume and balance level and mute and solo state changes originating from
75 the UI now send the correct assigned MIDI CCs, allowing for MIDI feedback
76 to controllers. Same for changes originating from reception of assigned MIDI
79 * The handler for right-clicking the input channel mute/solo buttons, was
80 accidentally removed and is now re-instated.
82 * Creating a new output channel assigns it a randomly chosen color,
83 which can be changed in the new channel dialog (used to work
84 some releases ago, but was broken at some point).
86 * The `jack_mix_box` command line options `--help` and `--stereo`
87 erroneously required an argument.
89 * Saving the current project on reception of the `SIGUSR1` signal, which is a
90 requirement for LADISH level L1 support, was broken in version 14.
92 * When re-ordering channels via drag-and-drop, the order of the edit / remove
93 channel menu items were not updated.
95 * When creating an output channel, it could happen that the initial channel
96 volume would randomly be set to -inf or 0 dB, regardless of what was
97 selected in new channel dialog.
102 * The minimum supported Python version is now 3.6.
104 * The `jack_mix_box` command line usage help message was improved.
106 * The channel strip buttons (solo, mute, etc.) now have more distinctive colors
107 when activated or the mouse hovers over them.
109 * The balance slider step size was increased slightly so right-clicking the
110 slider changes the value more rapidly.
112 * When using the "Save as..." function, `jack_mixer` now sets the default
113 filename and directory for file chooser to the last ones used.
115 * A window title was added to the preferences dialog.
117 * MIDI control for mute and solo now interprets control value 0-63 as off
118 and 64-127 as on, instead of toggling the state on reception of any
122 Project infrastructure and internals:
124 * The `jack_mixer_c` Python extension module, which was originally implemented
125 in hand-written C code using the PYTHON C API, was replaced with the
126 `_jack_mixer` extension module implemented in [Cython], which generates the C
127 code in `_jack_mixer.c`.
129 * The autotools build toolchain was replaced with a build setup using [meson],
130 which improves build times and maintainability markedly. See the file
131 [INSTALL.md] for updated build and installation instructions.
133 * A build option to allow building only `jack_mix_box` was added (`-Dgui=disabled`).
135 * All Python code was re-formatted with [black].
137 * All errors and warnings reported by [flake8] were fixed or are explicitly and
140 * The file `version.py` is now generated from the version set in the project
141 definition in the top-level `meson.build` file, leaving this as the only
142 place where the version number needs to be updated before a release.
144 * The `NEWS` file was renamed to `CHANGELOG.md` and converted to Markdown
147 This release was created by Christopher Arndt. With a contribution from
151 [INSTALL.md]: ./INSTALL.md
152 [black]: https://pypi.org/project/black/
153 [Cython]: https://cython.org/
154 [meson]: https://mesonbuild.com/
155 [flake8]: https://pypi.org/project/flake8/
158 ## Version 14 (2020-10-15)
160 * Changes to channel fader/meter layout and features:
161 * Added K20 and K14 scales.
162 * Added tick marks for left/center/right on balance slider and add tooltip
163 displaying left/right value.
164 * Added maximum width for control group labels. Labels are ellipsized if
165 too long and a tooltip with the full name is added.
166 * Channel add/property dialogs usability improvements:
167 * Remember last used settings for new input/outut channel dialogs (MIDI CCs
168 are always initialized with -1 by default, so they can be auto-assigned).
169 * Channel name is pre-filled in with "Input" or "output" and an
170 auto-incremented number suffix.
171 * Add mnemonics for all input/output channel dialog fields.
172 * When running under NSM, closing the main window only hides UI and the "Quit"
173 menu entry is replaced with a "Hide" entry.
174 * Added a global option to always ask for confirmation when quitting
176 * Allow drag'n'drop to change channel positions.
177 * Added ability to shrink/expand width of input and output channels.
178 * The font color of control group labels automatically adapts to their
179 background color for better contrast and readability.
180 * Fixed: Ctrl-click on volume fader sets it to 0.0 dbFS, not 1.0.
181 * Fixed: some issues with channel monitoring.
182 * Fixed: don't create empty project file on new NSM session.
183 * Fixed: on project load, give input focus to fader of last added channel and
184 deselect volume entry widget so keyboard input doesn't accidentally change
187 With contributions from Christopher Arndt, Daniel Sheeler and Frédéric Péters.
190 ## Version 13 (2020-07-16)
193 * Store preferences to per session config file to override global
195 * Added accelerator shortcuts to menu items.
196 * New ctrl-click, double-click, scroll, and click-drag-anywhere
198 * Added MIDI 'Pick Up' behavior to avoid discontinuities.
199 * Can choose output channel colors.
200 * Changed to logarithmic ramping on volume changes.
201 * Added a pre/post fader button.
202 * Pick volume for new channels.
203 * Allow manual setting of MIDI control change numbers.
204 * Remove GConf; use plaintext .ini preferences file instead.
205 * Remove remnants of Swig python bindings.
207 With contributions from Daniel Sheeler and Christopher Arndt.
210 ## Version 12 (2020-06-22)
212 * Added reporting of the current volume through SIGUSR1 signal to
214 * Reset color of over 0db/NaN peak on click.
215 * Fixed memory leaks.
216 * Fixed some Python 3 compatibility leftovers.
218 With contributions from Daniel Sheeler and Athanasios Silis.
221 ## Version 11 (2020-06-18)
223 * Spread out volume transition over a period of time to reduce
225 * Port to pygobject and GTK3.
228 With contributions from Daniel Sheeler.
231 ## Version 10 (2014-04-27)
233 * Fixed change of channel settings (#18299)
234 * Added a MIDI out port for feeding back volume levels into motorized
236 * Added jack_mix_box, a minimalistic (no UI) jack mixer
237 * Added a trayicon and minimize to tray feature
239 With contributions from John Hedges, Sarah Mischke, and Nedko Arnaudov.
242 ## Version 9 (2010-10-04)
244 * Changed to no longer appends PID to jack client name (#15006)
245 * Added 'Edit .. channel' submenus
246 * Set a default 'apply' button in channel properties
247 * Fixed creation of mono channels
248 * Removed bad crackling when changing the volume through MIDI
249 * Moved back to polling for MIDI events, to avoid the need for threads
250 * Changed to use backward compatible call to gobject.timeout_add (#14999)
251 * Updated not to fail if we can't get lash server name
252 * Added support for Ladish level 1
253 * Improved SIGUSR1 handling
255 With contributions from Nedko Arnaudov and Arnout Engelen.
258 ## Version 8 (2009-12-16)
260 * Fix private modules lookup
261 * Fix rotation of output channel colours
262 * New menu items to remove output channels
263 * New command line parameter to not connect to LASH
266 ## Version 7 (2009-12-14)
268 * New maintainer, thanks Nedko for everything!
269 * New icon by Lapo Calamandrei
270 * Option to have a gradient in the vumeters
271 * Option to use stock GtkScale widget for volume and balance
272 * Rewrite of the C/Python binding (this removed the dependency on SWIG)
273 * Improve performance when drawing vumeters
274 * New menu items to load/save settings
275 * New "Channel Properties" dialog, allowing to change assigned MIDI CCs
276 * Automatic post fader outputs for input channels
277 * Possibility to add new output channels, besides main mix
278 * New "monitor" output, assignable to any output channel, or input channel
279 (in which case it will take its prefader volume)
280 * Removal of PyXML dependency
282 With contributions from Nedko Arnaudov, Lapo Calamandrei, Arnout Engelen,
283 and Krzysztof Foltman.
286 ## Version 6 (2009-07-25)
288 * Fix building against jack 0.102.20
289 * Handle python prefix different from install prefix
290 * Fix LASH-less operation
291 * Update install instructions after lash-0.5.3 and phat-0.4.1 releases
292 * Apply Markus patch (thanks!) for sr #1698 (can't restore session using LASH)