diff --git a/README.md b/README.md index 10c0b0e..d240ae4 100644 --- a/README.md +++ b/README.md @@ -60,7 +60,7 @@ It is also possible to specify the configuration file to be used, by invoking mi # Basic Usage -The midizap program is a command line application, so you typically run it from the terminal, but of course it is also possible to invoke it from your desktop environment's startup files once you've set up everything to your liking. +The midizap program is a command line application, so you typically run it from the terminal. However, it is also possible to launch it from your Jack session manager (see *Jack-Related Options* below) or from your desktop environment's startup files once you've set up everything to your liking. Try `midizap -h` for a brief summary of the available options with which the program can be invoked. @@ -408,6 +408,8 @@ Spencer Jackson's [osc2midi][] utility makes for a great companion to midizap if Eric Messick's [ShuttlePRO][nanosyzygy/ShuttlePRO] program, on which midizap is based, provides pretty much the same functionality for the Contour Design Shuttle devices. +The [Bome MIDI Translator][] is a popular MIDI and keystroke mapping tool for Mac and Windows. It is proprietary software and isn't available for Linux, but if you're looking for a midizap alternative which runs on Mac and Windows, this seems to be your best bet. + # Authors midizap is free and open source software licensed under the GPLv3, please check the accompanying LICENSE file for details. @@ -417,10 +419,11 @@ Copyright 2018 Albert Graef () This is a version of Eric Messick's ShuttlePRO program which has been redesigned to use Jack MIDI instead of the Contour Design Shuttle devices that the original program was written for. -ShuttlePRO was written in 2013 by Eric Messick, based on earlier code by Trammell Hudson () and Arendt David (). The present version of the program, written by Albert Graef, is actually based on his [fork of ShuttlePRO][agraef/ShuttlePRO]. All the translation features of the original program are still there (in particular, key and mouse translations work exactly the same), but it goes without saying that the code has undergone some significant changes to accommodate the MIDI input and output facilities. The Jack MIDI driver code is based on code from Spencer Jackson's osc2midi utility, and on the simple_session_client.c example available in the Jack git repository. +ShuttlePRO was written in 2013 by Eric Messick, based on earlier code by Trammell Hudson () and Arendt David (). The present version of the program, written by Albert Graef, is based on his [fork of ShuttlePRO][agraef/ShuttlePRO]. All the translation features of the original program are still there (in particular, key and mouse translations work exactly the same), but it goes without saying that the code has undergone some significant changes to accommodate the MIDI input and output facilities. The Jack MIDI driver code is based on code from Spencer Jackson's osc2midi utility, and on the simple_session_client.c example available in the Jack git repository. [agraef/midizap]: https://github.com/agraef/midizap [agraef/ShuttlePRO]: https://github.com/agraef/ShuttlePRO [nanosyzygy/ShuttlePRO]: https://github.com/nanosyzygy/ShuttlePRO [osc2midi]: https://github.com/ssj71/OSC2MIDI [jackaudio/example-clients]: https://github.com/jackaudio/example-clients +[Bome MIDI Translator]: https://www.bome.com/products/miditranslator diff --git a/midizap.1 b/midizap.1 index b2b9af7..f3eca62 100644 --- a/midizap.1 +++ b/midizap.1 @@ -158,9 +158,11 @@ below to see exactly how your translations are being processed. .SH Basic Usage .PP The midizap program is a command line application, so you typically run -it from the terminal, but of course it is also possible to invoke it -from your desktop environment's startup files once you've set up -everything to your liking. +it from the terminal. +However, it is also possible to launch it from your Jack session manager +(see \f[I]Jack\-Related Options\f[] below) or from your desktop +environment's startup files once you've set up everything to your +liking. .PP Try \f[C]midizap\ \-h\f[] for a brief summary of the available options with which the program can be invoked. @@ -1041,6 +1043,12 @@ between MIDI and OSC (Open Sound Control). Eric Messick's ShuttlePRO (https://github.com/nanosyzygy/ShuttlePRO) program, on which midizap is based, provides pretty much the same functionality for the Contour Design Shuttle devices. +.PP +The Bome MIDI Translator (https://www.bome.com/products/miditranslator) +is a popular MIDI and keystroke mapping tool for Mac and Windows. +It is proprietary software and isn't available for Linux, but if you're +looking for a midizap alternative which runs on Mac and Windows, this +seems to be your best bet. .SH Authors .PP midizap is free and open source software licensed under the GPLv3, @@ -1059,8 +1067,8 @@ devices that the original program was written for. ShuttlePRO was written in 2013 by Eric Messick, based on earlier code by Trammell Hudson () and Arendt David (). -The present version of the program, written by Albert Graef, is actually -based on his fork of ShuttlePRO (https://github.com/agraef/ShuttlePRO). +The present version of the program, written by Albert Graef, is based on +his fork of ShuttlePRO (https://github.com/agraef/ShuttlePRO). All the translation features of the original program are still there (in particular, key and mouse translations work exactly the same), but it goes without saying that the code has undergone some significant changes