Now we'll setup the TouchOSC Bridge utility application to relay MIDI messages from and to TouchOSC.
Please note that any kind of firewall or security software running on your computer can be an absolute show-stopper when it comes to network communication, so if you have no success with the following steps, please try to disable those kind of applications temporarily and try again.
Open the downloaded dmg archive and drag the application (.app) bundle to your Applications folder
Run the downloaded installer and follow the instructions.
(The Windows version needs to set up a couple of things that are not included with the OS, such as a Virtual MIDI driver and a ZeroConf run-time for automatic network configuration).
Double-click the application (.app) bundle in your Applications folder
Find and run TouchOSC Bridge from the Start menu.
The application tries to stay out of your way as much as possible, so the only visual feedback it provides is to add an icon to the Menu-bar (macOS) or Task Tray (Windows) respectively:
PLEASE DO NOTE that to do its job of relaying messages to and from TouchOSC on your mobile device, TouchOSC Bridge HAS TO BE RUNNING! When launched the application creates two virtual MIDI ports on your system named TouchOSC Bridge, one for receiving MIDI messages sent from, and one for sending messages to, the TouchOSC app.
Using these ports any MIDI-capable application should be able to send and receive MIDI messages to and from the TouchOSC app. To learn how to configure TouchOSC to send and to react to MIDI messages in detail, please see the chapter on Editing Layouts.
To quit the application click/right-click the icon and select Quit from the contextual menu:
TouchOSC Bridge is now ready to receive MIDI messages from TouchOSC. We'll now setup TouchOSC to send some MIDI messages.
As an example of how to set up MIDI communication with TouchOSC Bridge, we'll configure Ableton Live to use TouchOSC Bridge's input and output ports.
Open Ableton Live's Preferences Dialog, select the section labelled "MIDI / Sync" and enable the Track and Remote columns for the MIDI Ports labelled TouchOSC Bridge:
Now Ableton Live is receiving and sending MIDI messages through TouchOSC Bridge. To confirm this, move or press any control in TouchOSC's Simple layout (which we loaded in earlier steps) and you should see the tiny light in the very top-right corner of Ableton Live light up whenever you do so:
Enter Ableton Live's MIDI Mapping mode by pressing the button labelled MIDI, also in the top-right corner. This will highlight all elements in Live's UI that can be assigned to MIDI controllers with a blue overlay. Select one of these elements, such as one of the Audio-channel's volume faders, and the next MIDI message received by Live will then be assigned to this UI element.
Move or press any of the controls in TouchOSC and you will see that Live will add a row to the MIDI Mappings window, and will add another overlay right above the selected UI element displaying details about the MIDI message, such as channel and type.
The element is now mapped bi-directionally between TouchOSC and Live. You can now exit Live's MIDI Mapping mode by clicking on the MIDI button in the top-right corner again and start controlling Live with TouchOSC! For more info on configuring Ableton Live please refer to Ableton's official manual.
Even though we were using Ableton Live in this example to show how to use TouchOSC to create a bi-directional MIDI-mapping, other applications can usually be configured in a similar fashion. Please refer to your application of choice's manual, specifically the MIDI mapping section, to find out how you can use TouchOSC Bridge and TouchOSC to build your own custom MIDI controller!