New in version 1.42, MidiBridge includes a module that converts
(binds) incoming MIDI messages on a port to inter-app OMAC fast-switch
messages. This feature allows you to switch between apps using buttons (or
keys) on a MIDI keyboard/controller or a remote app like TouchOSC running
on a separate device.
All Audeonic apps are fully OMAC fast switching compliant and hopefully
other devs will update their apps to support the switching too. If you want
your favourite app to be included in this, just hassle the developer of said
application to incorporate the OMAC registry class (free, unencumbered
open source) into
their app. If a dev needs information/assistance about the OMAC class and
registry just point them to our email address and we will do what we can.
Here are some resources that may be useful:
Now, on to the guide...
First you need to gather the MIDI messages that the device/app you want
to use to switch between apps sends. You need this as a space separated
string of MIDI bytes in hex. Our app MidiVision, which monitors MIDI on
an iDevice spits out the MIDI messages in exactly the right format. Here are
some examples of equipment we played with in setting this up:
|Akai Synthstation 25 SYNTH 1 button||B0 50 7F|
|Akai Synthstation 25 SYNTH 2 button||B0 51 7F|
|Akai Synthstation 25 SYNTH 3 button||B0 52 7F|
|Akai Synthstation 25 PREV button||B0 55 7F|
|Akai Synthstation 25 NEXT button||B0 54 7F|
|M-Audio Oxygen 49 C18 button||C0 00|
|M-Audio Oxygen 49 C19 button||C0 01|
|M-Audio Oxygen 49 C20 button||C0 02|
|M-Audio Oxygen 49 C21 button||C0 03|
|M-Audio Oxygen 49 C22 button||C0 04|
|Audeonic TouchOSC template 'MidiBridge'||B3 50 00|
|Audeonic TouchOSC template 'MidiVision'||B3 50 01|
|Audeonic TouchOSC template 'FreEWI'||B3 50 02|
|Audeonic TouchOSC template '<< Previous'||B3 50 0A|
|Audeonic TouchOSC template 'Next >>'||B3 50 0B|
All of the above are shipped as App Selector factory presets in
With your list of codes, think about which order you would like the apps
to be switched when using the Next/Previous commands as you will configure
the apps in that order in the App Selector module.
You need to add these messages to the app you want to switch
to (or the Next/Previous commands) in the MidiBridge app selector.
Touch the beaker icon
on any port from the main Interfaces tab, and scroll down to the App
Selector module. Press the disclosure arrow to bring up the panel:
- Rotate the picker wheel to focus on the first app you want to configure
(which will also be the first app in the Next/Previous cycle). If an app is
known to be fully OMAC switchable then it will have a star next to it. Apps
will gain stars magically via the OMAC registry which gets downloaded
to your device when the registry is updated by OMAC.
- In the white text box enter the MIDI message that you want to trigger a
switch to the selected app and press Done. MidiBridge will sanity check the
data and if OK will set the value. If you get it wrong, check your message
format and try again. Remember to separate each hex byte with a space.
Repeat the above for each app you want to control, and finally enter the
codes you want to use to trigger a Next or Previous app switch by entering
the appropriate MIDI code when the picker is focussed to Next or Previous.
Save your work by touching the white down-pointing triangle and using the
Save button to name and save your preset so it can be used on any port in
Note, that you can configure a message to switch to a non-starred app, but
the switching will only work if a fully OMAC compliant app is in the
foreground. Once you switch to a non-starred app, then you will have to
switch away from that app manually by doing the double-tap on home button or
if the app has a fast-switch UI you can use that.
Hopefully, you chose the MIDI port to configure the App Selector from
which your MIDI switching messages will come into MidiBridge. If not, don't
worry, as since you saved your efforts in a preset, you just need to touch
the beaker icon on the relevant port and load in the saved preset into the
App Selector module.
Don't forget that you can turn on an App Selector on a MIDI
destination port too and you could even program switching messages to be
generated from an onboard MIDI sequencer and have it switch between apps
at certain times during your performance.
That wraps up the configuration of the App Selector. As always if you
have any suggestions, comments or just need help in setting things up with
MidiBridge you can email us or nudge us on twitter.