nixo
/
midizap
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Text changes, add a note about the Bome MIDI translator.

master
Albert Graef 2018-08-20 07:09:52 +02:00
parent 5d53e50558
commit 9a4830703d
2 changed files with 18 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
README.md
View File

@ -60,7 +60,7 @@ It is also possible to specify the configuration file to be used, by invoking mi
# Basic Usage # 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. 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. 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 # Authors
midizap is free and open source software licensed under the GPLv3, please check the accompanying LICENSE file for details. 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 (<aggraef@gmail.com>)
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. 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 (<hudson@osresearch.net>) and Arendt David (<admin@prnet.org>). 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 (<hudson@osresearch.net>) and Arendt David (<admin@prnet.org>). 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/midizap]: https://github.com/agraef/midizap
[agraef/ShuttlePRO]: https://github.com/agraef/ShuttlePRO [agraef/ShuttlePRO]: https://github.com/agraef/ShuttlePRO
[nanosyzygy/ShuttlePRO]: https://github.com/nanosyzygy/ShuttlePRO [nanosyzygy/ShuttlePRO]: https://github.com/nanosyzygy/ShuttlePRO
[osc2midi]: https://github.com/ssj71/OSC2MIDI [osc2midi]: https://github.com/ssj71/OSC2MIDI
[jackaudio/example-clients]: https://github.com/jackaudio/example-clients [jackaudio/example-clients]: https://github.com/jackaudio/example-clients
[Bome MIDI Translator]: https://www.bome.com/products/miditranslator

18
midizap.1
View File

@ -158,9 +158,11 @@ below to see exactly how your translations are being processed.
.SH Basic Usage .SH Basic Usage
.PP .PP
The midizap program is a command line application, so you typically run 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 it from the terminal.
from your desktop environment's startup files once you've set up However, it is also possible to launch it from your Jack session manager
everything to your liking. (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 .PP
Try \f[C]midizap\ \-h\f[] for a brief summary of the available options Try \f[C]midizap\ \-h\f[] for a brief summary of the available options
with which the program can be invoked. 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) Eric Messick's ShuttlePRO (https://github.com/nanosyzygy/ShuttlePRO)
program, on which midizap is based, provides pretty much the same program, on which midizap is based, provides pretty much the same
functionality for the Contour Design Shuttle devices. 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 .SH Authors
.PP .PP
midizap is free and open source software licensed under the GPLv3, 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 ShuttlePRO was written in 2013 by Eric Messick, based on earlier code by
Trammell Hudson (<hudson@osresearch.net>) and Arendt David Trammell Hudson (<hudson@osresearch.net>) and Arendt David
(<admin@prnet.org>). (<admin@prnet.org>).
The present version of the program, written by Albert Graef, is actually The present version of the program, written by Albert Graef, is based on
based on his fork of ShuttlePRO (https://github.com/agraef/ShuttlePRO). his fork of ShuttlePRO (https://github.com/agraef/ShuttlePRO).
All the translation features of the original program are still there (in All the translation features of the original program are still there (in
particular, key and mouse translations work exactly the same), but it particular, key and mouse translations work exactly the same), but it
goes without saying that the code has undergone some significant changes goes without saying that the code has undergone some significant changes