Sunday, January 23, 2011

How-To: Interface TouchOSC with Windows Vista

So I've been working with Ableton Live for a month or two now and have come to realize just how important it is to have a MIDI controller. Doing everything by hand with the keyboard and mouse really sucks ass.

Enter TouchOSC, brought to you by Hexler.
I watched a few YouTube videos and immediately downloaded the app for 5 whole dollars.
I soon came to find that I needed a program called OSCulator to get TouchOSC to interface with OS X.
Not to worry, my Google-Fu is strong. This is a tutorial on how to get your TouchOSC to work with a PC. It took me a very long time to find everything I needed to make it work, so I hope this helps!

What I aim to do here is give you the easiest and fastest way to get TouchOSC up and running on your Windows PC and save you the full DAY I spent trying to figure out how to get it to work.  This is going to take some time and some effort, so sit the fuck down and read this shit all the way through FIRST. Then you can start clicking links and shit.

Here's an outline of the instructions we'll be going over. You should already have the software you're attempting to interface with downloaded and installed and ready to go. (Ableton Live, Traktor, Virtual DJ, etc.)

  1. Download TouchOSC to your iDevice (I'm using a 2nd generation iPod Touch for this.) from the Apple Store and set it up. This can be a little tricky, what with finding the personal IP address for your computer.
  2. Download the .rar file here. This contains all of the installers and files you will need, including the stock templates and the PD conversion tool.
  3. Install MapleVMCv356.exe FIRST. You will need to restart your computer after this is installed.
  4. After restarting your computer, install "Pd-0.42.5-extended-windowsxp-i386.exe" and put a shortcut on the desktop. This program is called Pure Data. Later on, we will be converting your custom TouchOSC layouts into PD files for interfacing. You will need this program running in order for the devices to communicate with one another.
  5. Here's where it gets a little bit tricky. So far, we've installed Maple and its audio drivers, letting us trick Pure Data into sending MIDI in/out to whatever software we're using. Now you're going to use "touchosc2pd.jar." All this does is takes your layout file (.touchosc) and turns it into something Pure Data can use (.pd)
  6. After you've run your .touchosc file through touchosc2pd, open PD-Extended and then open your layout file. Once the layout is open, click "Media," then "MIDI Settings..." and set your output device to "Maple MIDI Out: Port 1." You are now sending an OSC signal from your iDevice to the Maple MIDI drivers, being translated by Pure Data. Now the only thing you have left to do is set your input ports on whatever software you're using.

Here's what your MIDI device preferences should look like in Ableton Live 8.
Make sure your "Track" and "Remote" settings are switched to ON and the INPUT channel on the software you're trying to control matches the OUTPUT on Pure Data.

This is how I got TouchOSC to work on my Windows Vista machine.
Please leave a comment if you have any questions or if any of the links are broken, I'm really only doing this so other people won't have as much trouble as I did getting this to work.

Special thanks to Hexler for creating TouchOSC and the PD patcher tool. Thanks to the Pure Data, Maple, Ableton Live, Traktor Pro, and Apple teams for making such awesome shit that we can play with.