h e x l e r . n e t

pixels, waves and hyperactivity disorder

TouchOSC

TouchOSC is a universal iPhone / iPod Touch / iPad application that lets you send and receive Open Sound Control messages over a Wi-Fi network using the UDP protocol.

Description

The application allows to remote control and receive feedback from software and hardware that implements the OSC protocol such as Pure Data, Max/MSP/Jitter, OSCulator, VDMX, Resolume Avenue 3, Modul8, Plogue Bidule, Reaktor, Quartz Composer, Vixid VJX16-4, Supercollider, FAW Circle, vvvv, Derivative TouchDesigner and others.

The interface provides a number of different touch controls to send/receive messages:

• Faders
• Rotary controls
• Push buttons
• Toggle buttons
• XY pads
• Multi-faders
• Multi-toggles
• LEDs
• Labels (New!)

It supports full multi-touch operation, five controls can be used at the same time. Additionally the program can send Accelerometer data. The application comes with five default layouts that are organized in multiple pages but custom layouts can be constructed using the TouchOSC Editor application.

TouchOSC Editor

Download the editor application for OS X, Windows and Linux to design and upload custom layouts for TouchOSC for iPhone/iPod Touch and iPad:

touchosc-editor-1.4-osx.zip OS X

touchosc-editor-1.4-win32.zip Windows

touchosc-editor-1.4-noarch.zip Linux/other


Default layouts shipping with TouchOSC:

touchosc-default-layouts.zip

 
 

Documentation

Download the manual for version 1.1

• PDF
• HTML

Videos

Making Music with iPad	iPad MPC Style Drum Pads – TouchOSC with Propellerhead Record	Novation 25SL Compact iPod Touch TouchOSC MOD	Supercollider + TouchOSC = Step Sequencer	Controlling Serato 2.0 With iPad
Controlling Reaktor	TouchOSC / Ableton Live	TouchOSC & VDMX	TouchOSC controlling Traktor	TouchOSC controlling VirtualDJ

Examples

Ableton Live

• LiveControl – Complete control of Ableton Live using your iPad or iPod

• Tutorial on setting up TouchOSC with OSCulator and Live on OS X
• How-to on setting up TouchOSC with Pure Data, MIDI Yoke and Live on Windows
• A MIDI Remote Script for TouchOSC

Circle

• Simple CircleOSC – An application to interface with FAW’s Circle, by Synpatic Failure

Logic

• Three part tutorial on using TouchOSC with Logic Pro
• How-to on Logic/OSCulator/TouchOSC setup, by Brett Terpstra @ TUAW

Max/MSP

• basic.maxpat.zip – Basic sending/receiving
• max5-beatmachine-send-and-receive.zip – Sending and receiving for the “Beatmachine” layout (by Florian Schulz)
• max5-beatmachine-rotaries2midi.zip – Sending MIDI from the rotaries on page 3 of the “Beatmachine” layout (by Florian Schulz)
• simple-send-and-receive.zip – Sending and receiving for the “Simple” layout (by Mitchell Turner)
• mix16-send-and-receive.zip – Sending and receiving for the “Mix16″ layout (by Mitchell Turner)
• touchosc-midikeys-v1-1a.zip – Sending MIDI Notes and CC’s for the “Keys” layout (by Matthias Schneiderbanger)

MIDI

As most audio/visual software does not support OSC directly (yet), in order to use TouchOSC with these applications the incoming OSC messages need to be translated into MIDI messages. If you are on Mac OS X please check the OSCulator files on this page. This is by far the easiest way to convert OSC messages from TouchOSC to MIDI on the Mac OS X platform.

To translate OSC messages from TouchOSC to MIDI messages on Windows follow these steps:

1. Download and install Pure Data Extended
2. Download and install MIDIYoke
3. Download and open one of the Pure Data MIDI patches following this section (for example: simple-midi.pd)
4. Make sure you are receiving output from TouchOSC in Pure Data. Refer to the TouchOSC manual on this page for more information
5. In Pure Data open the menu Media -> MIDI Settings…
6. For output device 1 select Out To MIDI Yoke: 1 and press OK
7. Start the application you want to receive the MIDI messages with, go to MIDI settings/preferences and select In From MIDI Yoke: 1 as input
8. Use the MIDI learn function of the application to map controls from TouchOSC to controls in the application

Pure Data MIDI patches:

• simple-midi.pd – All controls in the “Simple” layout mapped to MIDI CC’s
• mix16-midi.pd – All controls in the “Mix 16″ layout mapped to MIDI CC’s (by Dan Myers)
• mix2-midi.pd – All controls in the “Mix 2″ layout mapped to MIDI CC’s (by Jeremy Stacy)
• beatmachine-channels-midi.pd – Beatmachine MIDI patch with switchable channels (by Jeremy Stacy)
• beatmachine-midi.pd – All controls in the “Beatmachine” layout mapped to MIDI CC’s (by Velvetsol)
• keys-high-midinotes.pd – “Keys” layout mapped to MIDI Notes (by Jonathan Asher)
• keys-low-midinotes.pd – “Keys” layout mapped to MIDI Notes (by Jonathan Asher)
• touchosc2pd – Pure Data Patch Generator to create PD patches with optional MIDI CC mapping automatically from custom layouts

OSCulator

• simple.oscd – All controls in the “Simple” layout mapped to MIDI CC’s 0-102, Channel 1
• mix2.oscd – All controls in the “Mix 2″ layout mapped to MIDI CC’s 0-52, Channel 1
• mix16.oscd – All controls in the “Mix 16″ layout mapped to MIDI CC’s 0-90, Channel 1
• beatmachine.oscd – All controls in the “Beatmachine” layout mapped to MIDI CC’s, Channels 1-4
• keys.oscd – First two pages mapped to MIDI Notes, third page mapped to MIDI CC’s, Channel 1 (thanks to Zettt)
• Setting up Osculator and Ableton Live – Setting up 2-way communication with Ableton Live using OSCulator (Thx Camille!)

Pure Data

• basic.pd – Basic sending/receiving
• simple-receive.pd – Receiving messages from the “Simple” layout
• beatmachine-receive.pd – Receiving messages from the “Beatmachine” layout
• mix16-receive.pd – Receiving messages from the “Mix 16″ layout
• mix2-receive.pd – Receiving messages from the “Mix 2″ layout

Processing

• simple.pde – Receiving and displaying messages from the “Simple” layout (page1 only). Requires the oscP5 library.
• Example code for handling accelerometer data
• Processing Apps – Processing examples + video by Mike Cook

Quartz Composer

• qcOSC – Bonjour enabled and auto-populating OSC receiver plug-in
• touchosc-quartz-composer.zip – Example patches (by Toby Cole)

Reaktor

• Tutorial on how to set up Reaktor with TouchOSC by CircleSix
• simple.ens – Receiving values from the “Simple” layout
• mix2.ens – Receiving values from the “Mix 2″ layout

Supercollider

• touchosc-simple.scd – GUI example for the “Simple” layout (by Wilm Thoben)

Torq

• using-touchosc-with-m-audio-torq.pdf – Tutorial on setting up TouchOSC with M-Audio Torq (by Dan Myers)

Vixid VJX16-4

• vixid_vjx16-4_touchosc_layouts_v1.0.rar – Layouts, PD patches and manual for setting up TouchOSC with the VJX16-4, kindly provided by Vixid

vvvv

• touchosc-and-vvvv-version07.zip – Example by strukt
• touchosc-simple-p1-vvvv.zip – Example by Rainer Kohlberger

Support

Problems? Suggestions? Send e-mail to dev@hexler.net

Related

If you like TouchOSC please check out SonicLife, another OSC enabled controller application by hexler

20xx | dev at hexler dot net

RSS