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


The Wiimote drawer

Kyma Users: Obtain the Sounds

Follow this tutorial written by Carla Scaletti to learn about how to use the Wiimote as a direct controller for the Kyma Workstation. All users, whether they own a Kyma or not are encouraged to read this tutorial as it can help to learn how to use the Wiimote with OSCulator.

Connecting the Wiimote

Wiimote connection status To connect the Wiimote to OSCulator, press buttons 1 & 2 and wait a few seconds. You can know when OSCulator is performing a search if the message “Press buttons 1 & 2 to connect your Wiimote” is displayed in the lower right corner of the main window.

By default, OSCulator will search for Wiimotes at launch. You can control this parameters in the Preferences.

Wiimote drawer toolbar icon If you want to manually start a search, open the Wiimote drawer by clicking the last icon in the toolbar. Then, click the button labeled “Start discovery”. A spinning indicator will show that a discovery search is being performed.

If an error occurs, a message is displayed in red in the Wiimote status area. For example, errors can occur when the Wiimote is low on battery. If the Perfect Pairing extension has been installed, you should never get a message1).

You can choose the slot number assigned to the Wiimote by clicking on the drop down menu displayed right to the Wiimote address field. This is useful for using several Wiimote at a time. Note that you can connect up to 4 to 6 Wiimotes simultaneously depending on your Mac model.

When the Wiimote is connected, a Wii™ logo is displayed at the lower right corner of the main window. Also, a led is turned on on the Wiimote to reflect the assigned slot number.

Using the Wiimote

As soon as the Wiimote is connected, empty messages are displayed in the list. If you're using Kyma, the messages are automatically configured with Kyma Control Changes events, making the Wiimote readily usable.

Just like every messages, simply configure the events you want to perform. For example to send a MIDI Control Change that has the value of the Wiimote acceleration, locate the line that is labelled “accel”, select “MIDI CC” in the Event Type column, and choose any number you like from the Value column.

The Wiimote OSC messages are labeled as follows:

/wii/[wiimote id]/{extension device/}[control type]/{acceleration type}

Here is what it means:

  1. first, we have the /wii prefix
  2. next, the number assigned to the connected wii
  3. optionally, if an extension device is connected, its name, which can be nunchuk of classic for the classic controller
  4. the control type, which can be button, accel, ir, or joy (for joysticks)
  5. finally, if the control type is an acceleration, the accerelation format, which can be xyz (for the X, Y and Z axes of the Wiimote or Nunchuk), and pry (for Pitch, Yaw, Raw and Scalar acceleration)
  • for the xyz acceleration control type, there are 3 arguments, which correspond to the respective X, Y and Z accelerations.
  • for the pry acceleration control type, there are 4 arguments, which correspond to Pitch, Roll, Yaw, and the Scalar acceleration (combination of all the accelerations, which gives a meaning of the strengh of the movement applied to the Wiimote.)
  • for the ir control type, there are 2 arguments, which are the X and Y coordinates.
  • for the joy control type, there are 2 arguments, which are the X and Y coordinates of the joystick.
  • if you have enabled Raw IR output, you can track up to 4 IR points (like IR LED or a mere candle). The suffix xys is added with the number of the tracked point. 3 actions are assigned to this OSC message, which are respectively the coordinates X and Y, and the size of the point, S.

Filtering output

You can choose to output only a part of the data given by the Wiimote. To do this, click on the checkboxes matching the data you want to enable or disable in the Wiimote drawer.

You can choose between:

Raw Accelerations (x, y, z)
These are the acceleration values as measured by the accelerometer chip of the Wiimote.
Pitch, Raw, Yaw, Acceleration
These values represent the orientation of the remote. These values are derived from the x, y, and z accelerations. The last information, Acceleration, is the scalar value (overall value) of {x, y, z}.
These values represent the x and y coordinates of an imaginary point to which the Wiimote is directed.
Raw IR (x, y, size / 4 tracked dots)
These are the values as given by the built-in infrared camera. The Wiimote can track up to 4 dots. Their x, y coordinates are reported as well as the sizes of the dots.

Smoothing out the data

If you feel like the Wiimote output is too jerky, you can smooth it out by applying a filter on it. Simply adjust the sliders to taste. A value of 0 means “no smoothing”, whereas a values of 100 means “maximum smoothing”.

How the settings are saved

The settings you customize in the Wiimote drawer are saved in the OSCulator document you are working on. This is useful to take you settings with you if you change of computer.

However, the Wiimotes addresses and their mapping numbers are stored in the Preferences of the application. Hence, this configuration is stored on the computer that is running the application.

Sync LEDs with Preset #

If you are using many presets, you can make the LEDs display the preset number instead of the Wiimote number.


There is a bug in the Mac OS X implementation of Bluetooth that makes the Wiimote connection difficult on some computers. However, since OSCulator 2.5.1, an add-on to your system can be installed in order to prevent this problem to arise.

The most affected are G4 and G5 based computers running Mac OS X Tiger (10.4).

On first launch, you will be automatically guided through the installation of the Wiimote called the Perfect Pairing Extension. You can still choose to revert the changes in the Preferences window.

it is also possible that your Wiimote is not supported yet, if this is the case, please contact the author
manual/wiimote.1244062979.txt.gz · Last modified: 2009/06/03 23:02 by camille