Add i18n/l10n for jack_mix_box and jack_mixer C library
[jack_mixer.git] / CHANGELOG.md
blob99e508c66879e7fd4fc68a2840144872a46a26fe
1 Change Log
2 ==========
5 ## Version 15.1 (2021-03-15)
7 **Bugfix release**
9 Fixed:
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
16   debug log messages.
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
31   via NSM).
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.
45 New:
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.
68 Fixed:
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
77   CCs.
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.
100 Changed:
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
119   controller value.
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
138   selectively ignored.
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
145   format.
147 This release was created by Christopher Arndt. With a contribution from
148 Athanasios Silis.
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
175   jack_mixer.
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
185   the value.
187 With contributions from Christopher Arndt, Daniel Sheeler and Frédéric Péters.
190 ## Version 13 (2020-07-16)
192 * Added NSM support.
193 * Store preferences to per session config file to override global
194   preferences.
195 * Added accelerator shortcuts to menu items.
196 * New ctrl-click, double-click, scroll, and click-drag-anywhere
197   fader behaviors.
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
213   jack_mix_box.
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
224   discontinuities.
225 * Port to pygobject and GTK3.
226 * Port to Python 3.
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
235   controllers
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)