User Tools

Site Tools


quickstart:start

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Last revisionBoth sides next revision
quickstart:start [2009/06/04 02:37] camillequickstart:start [2016/12/15 09:55] – [Wiimote] camille
Line 3: Line 3:
 ===== Obtaining the software ===== ===== Obtaining the software =====
  
-  * [[http://www.osculator.net/wp/download|Download the latest version here]] +  * [[https://osculator.net/download|Download the latest version here]] 
-  * Open the file you just downloaded and drag the OSCulator folder to your Applications folder +  * Open the file you just downloaded and drag OSCulator to your Applications folder 
-  * Launch the application and follow the initial setup instructions+  * Launch the application
  
 ===== Use a Sample Patch ===== ===== Use a Sample Patch =====
  
 The OSCulator software comes with many "ready to go" example files. 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.+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.
  
 ===== Input Setup ===== ===== Input Setup =====
  
-When launched OSCulator shows an empty window. +When launched OSCulator shows an empty window.  It is actually listening for incoming messages.  It can be OSC messages on default port 8000 or MIDI messages sent to the virtual port "OSCulator In (8000)"
-It is actually listening for incoming messages. +As soon it receives data, you can use it to trigger events (see [[#Output Setup|that section]]).
-As soon it receives OSC data, you can use it to send it to another application (see [[#Output Setup|that section]]).+
  
 ==== Wiimote ==== ==== Wiimote ====
  
-  - Plug any extension you want to use with your Wiimote and press buttons 1 & 2 of your Wiimote +  - Open the Parameters Window (click the gear icon ⚙ in the toolbar) ; 
-  - A list of messages should appear in the main window +  - In Devices, go to Wiimote 
-  - Proceed to [[#Output Setup|configuring the outputs]]+  - Pair your Wiimote with your computer (you don't have to do this again) ; 
 +  - Once paired, just press any button of your Wiimote twice to connect it ; 
 +  - Proceed to [[#Output Setup|configuring the events]].
  
-==== iPhone / iPod Touch ====+==== iPhone / iPod Touch / iPad ====
  
   - Unless you have it already, download an OSC compatible application on the App Store like:   - Unless you have it already, download an OSC compatible application on the App Store like:
Line 30: Line 31:
     * [[http://lux.vu/blog/oscemote/|OSCemote]]     * [[http://lux.vu/blog/oscemote/|OSCemote]]
     * [[http://poly.share.dj/wiki/index.php/Mrmr|mrmr]]     * [[http://poly.share.dj/wiki/index.php/Mrmr|mrmr]]
-  - Connect your iPhone to the same network as the computer that is running OSCulator +  - Connect your iPhone to the same Airport network as the computer that is running OSCulator ; 
-  - Configure the aforementioned application so it sends OSC messages to that computer (you can follow [[tutorial:1:|that tutorial]] that has been written for TouchOSC, other applications work about the same) +  - Configure the iOS app so it sends OSC messages to that computer (you can follow [[tutorial:1:|that tutorial]] that has been written for TouchOSC, other applications work about the same) ; 
-  - 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 +  - 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 ; 
-  - Proceed to [[#Output Setup|configuring the outputs]]+  - Proceed to [[#Output Setup|configuring the events]].
  
 ==== Logitech SpaceNavigator ==== ==== Logitech SpaceNavigator ====
  
-  - Connect the SpaceNavigator to an USB port +  - Connect the SpaceNavigator to an USB port ; 
-  - Click on the menu item Window -> Use SpaceNavigator +  - Click on the menu item Window -> Use SpaceNavigator ; 
-  - Rock and roll+  - Proceed to [[#Output Setup|configuring the events]]. 
 ==== OSC enabled software or device like the Lemur ==== ==== OSC enabled software or device like the Lemur ====
  
Line 46: Line 48:
   * The [[http://www.jazzmutant.com/|JazzMutant Lemur]] is usually sending its data on port ''8000''.   * 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 /Applications/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 Airport, drop the menu down to ''Network Interface (en1)'' 
-    * if your computer is connect with Ethernet, change the drop down menu to ''Network Interface (en0)''+    * if your computer is connect with Ethernet, drop the menu down to ''Network Interface (en0)'' 
  
 ===== Output Setup ===== ===== Output Setup =====
Line 55: Line 58:
 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. 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.+For the sake of keeping the quick start guide minimal, we will only describe the MIDI Control Change event. 
  
 ==== MIDI Control Changes ==== ==== MIDI Control Changes ====
  
-To be able to send MIDI Control Change data+To be able to send MIDI Control Change events
-  - locate the message that corresponds to the particular control you want to bind and choose ''MIDI CC'' in the Event Type column +  - 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''. +    * 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 +  - in the Value column, choose control change number that is not used yet ; 
-  - 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.+  - 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 Out" virtual MIDI port ;
   - 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)).   - 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)).
  
  
quickstart/start.txt · Last modified: 2017/01/29 09:36 by camille