User Tools

Site Tools


This is an old revision of the document!

Warning: Declaration of syntax_plugin_blockquote_quote::handle($match, $state, $pos, &$handler) should be compatible with DokuWiki_Syntax_Plugin::handle($match, $state, $pos, Doku_Handler $handler) in /home/clients/a70cbb4a74edf8105da5fd7e142fb9de/web/doc/lib/plugins/blockquote/syntax/quote.php on line 119

Warning: Declaration of syntax_plugin_blockquote_quote::render($mode, &$renderer, $indata) should be compatible with DokuWiki_Syntax_Plugin::render($format, Doku_Renderer $renderer, $data) in /home/clients/a70cbb4a74edf8105da5fd7e142fb9de/web/doc/lib/plugins/blockquote/syntax/quote.php on line 119

Quick Start Guide

Obtaining the software

  • Open the file you just downloaded and drag the OSCulator folder to your Applications folder
  • Launch the application and follow the initial setup instructions

Input Setup

When launched OSCulator shows an empty window. It is actually listening for incoming messages. As soon it receives OSC data, you can use it to send it to another application (see that section).


  1. Plug any extension you want to use with your Wiimote and press buttons 1 & 2 of your Wiimote
  2. A list of messages should appear in the main window

iPhone / iPod Touch

  1. Unless you have it already, download an OSC compatible application on the App Store like:
  2. Connect your iPhone to the same network as the computer that is running OSCulator
  3. Configure the aforementioned application so it sends OSC messages to that computer (you can follow that tutorial that has been written for TouchOSC, other applications work about the same)
  4. Touch some controls on the application running of the iPhone to test if the messages are well received by OSCulatorn they should appear in the list

Logitech SpaceNavigator

  1. Connect the SpaceNavigator to an USB port
  2. Click on the menu item Window → Use SpaceNavigator
  3. Rock and roll

OSC enabled software or device like the Lemur

  • Any OSC enabled software or device can natively send data to OSCulator. All you have to do is to make sure that the OSC output port of your device matches the OSC input port of OSCulator.
  • Software based on the TUIO protocol will work out of the box too, though it might be easier for you to use the OSC input port 3333.
  • The JazzMutant Lemur is usually sending its data on port 8000.
  • To know the IP address of your computer, open the Network Utility application 1) and look for the IP Address.
    • if your computer is connect with Airport, change the drop down menu to Network Interface (en1)
    • if your computer is connect with Ethernet, change the drop down menu to Network Interface (en0)

Output Setup

Now that you have a working input, you can transform the incoming data to something useful.

Each line in OSCulator represents a received message. There is a blinking light to indicate when activity has changed, so you know when data comes in. The Event Type and Value columns are important, the first lets you choose the nature of the action you want to perform with your controller, and the second lets you configure it.

For the sake of keeping the quick start guide minimal, we will only describe the MIDI Control Change configuration.

MIDI Control Changes

To be able to send MIDI Control Change data:

  1. locate the message that corresponds to the particular control you want to bind and choose MIDI CC in the Event Type column
    • for example if you want to use the Roll of the Wiimote to control MIDI CC #16, select the message “1: roll” under /wii/1/accel/pry.
  2. in the Value column, choose the control change number
  3. now go to the software that will receive the control changes (Ableton Live for example), and open the preference for this software. There should be a MIDI panel where you must activate the “OSCulator Input” virtual MIDI interface.
  4. depending on how the target software work, you may want to activate a MIDI learn mode2), or manually configure the control change number3).
located in /Applications/Utilities
like in Live
like in Traktor
quickstart/start.1236867165.txt.gz · Last modified: 2009/03/12 15:12 by camille