Differences

This shows you the differences between two versions of the page.

--- quickstart:start [2009/03/12 15:01] – camille
+++ quickstart:start [2009/06/04 02:37] – camille
@@ Line 6: / Line 6: @@
   * Open the file you just downloaded and drag the OSCulator folder to your Applications folder
   * Launch the application and follow the initial setup instructions
+===== Use a Sample Patch =====
+The OSCulator software comes with many "ready to go" example files.
+Although it is recommended to read through this entire Quick Start Guide, you can start by using these sample files, located in the "Sample Patches" folder.  A companion document named "About the Sample Patches" provides hints and describes their usage.
 ===== Input Setup =====
@@ Line 40: / Line 45: @@
   * 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 [[http://www.jazzmutant.com/|JazzMutant Lemur]] is usually sending its data on port ''8000''.
-  * To know the IP address of your computer, open the Network Utility application ((located in /Application/Utilities)) and look for the IP Address.
+  * To know the IP address of your computer, open the Network Utility application ((located in /Applications/Utilities)) 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)''
@@ Line 47: / Line 52: @@
 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:
+  - 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''.
+  - in the Value column, choose the control change number
+  - 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.
+  - depending on how the target software work, you may want to activate a MIDI learn mode((like in Live)), or manually configure the control change number((like in Traktor)).