beatfix studios

Hardware Requirements

• A computer that runs Windows and has a Bluetooth adapter
• A Nintendo Wiimote controller with Nunchuk

Software Requirements

• MIDI Yoke (download / web site)
• Whorld 1.7.06 (download / web site)
• GlovePIE 0.29 (download / web site)
• The WiiWhorld script (”WiiWhorld.PIE”) (download)

Setting Up

• Install MIDI Yoke.  Set “MIDI Yoke NT: 1″ as your default MIDI playback device in Windows.  (instructions here)
• Unpack the .zip files for the Whorld software, GlovePIE, and the WiiWhorld script.
• Install Whorld.  Run Whorld.  From the menu bar in Whorld, select View -> Options -> MIDI.  From the pulldown list, select “MIDI Yoke NT: 1″.
• Open the GlovePIE folder.  Run GlovePIE.exe (no installation required).  From the menu bar in GlovePIE, open “WiiWhorld.PIE” (File -> Open -> )  Do not click the “Run” button yet.

Pairing the Wiimote

The exact process will vary, depending on your Bluetooth stack.  Here are the key points you need to know:

• The Wiimote must be in discoverable mode throughout the pairing process.  Press and hold the “1″ and “2″ buttons on the Wiimote simultaneously, and continue to hold them until the pairing process is complete.
• If you are pairing your Wiimote for the first time, you may need to add it as a new Bluetooth device.
• The Wiimote is recognized by Bluetooth as a HID (human interface device).
• The Wiimote does not require a passkey.  If you are prompted to enter a passkey, decline or skip it.

If you would like more detailed instructions:
Bluesoleil Bluetooth stack
Built-in Windows Bluetooth stack

And Away We Go!

Once you have successfully paired your Wiimote:

• Go back into GlovePIE.  Click the “Run” button.  You should see numbers moving in the debug box (immediately to the right of the “Run” button).  If you don’t see anything, then your Wiimote is not properly paired, and you need to go through the pairing process again.
• Connect the Nunchuk to the Wiimote, if you haven’t already.
• Go into Whorld.  Shake your Wii.  If everything is working, you should be able to tell right away.
• To put Whorld in fullscreen mode, press F11 on your keyboard.  Have fun!

Notes:

For convenience, I like to associate the .PIE file extension to automatically open with GlovePIE, and then create a desktop shortcut to the WiiWhorld.PIE script.  Do whatever works best for you.

Occasionally the Nunchuk will lose its connection with the Wiimote, and stop responding.  This can usually be fixed by simply unplugging the Nunchuk from the Wiimote, and then plugging it back in.