How does it work?
In addition to the traditional buttons, force feedback and the integrated mini-speaker, the true innovation is the presence of a gravity and acceleration sensor (the ADXL330, used in the army or automobile safety, for airbags systems) inside the Wiimote which collects the movements and acceleration of the Wiimote on each of the 3 axis, X, Y et Z.

The good news is that rather than using a proprietary protocol to transmit the infos from the Wiimote to the Wii, and then lock its hardware to keep an exclusive use of it, Nintendo has made the excellent decision (probably by commercial will) to use the Bluetooth protocol, standard of communication on PC and Mac for several years. This means that you can connect your Wiimote to your computer, and  program it rather simply for any use you want.

- – - – - – - – - – - -

In this Post, we will learn how to connect Wiimote to a PC, and how to transform the values received into MIDI signals, to be able to control any VJing software (like Arkaos) or production/live audio (Ableton to mention only one of them).

Requirements:
- A Wiimote, of course (approximately £20/35$, online or at your local  video games shop).
- A Bluetooth Dongle (if your computer doesn’t have Bluetooth already, about £10/15$).
- Bluesoleil (shareware, it usually comes for free with Bluetooth dongles).
- GlovePie (freeware).
- MidiYoke (freeware, required for MIDI).

Connect your Wiimote to your PC:
Once your dongle installed, your Wiimote unpacked and filled with fresh batteries:
1 - Launch Bluesoleil (a grey icon appears in the taskbar, and then becomes blue once once the Bluetooth dongle initialized. Now, double-click on the blue icon to launch the program)
2 - You have to enable the “detection” mode: press simultaneously buttons 1 and 2 of your magic remote (LEDs start to flicker).
In Bluesoleil, start ”device detection” by clicking on the orange sphere in the middle.
3 - Your Wiimote has been detected, and appears as an icon in Bluesoleil, now you must activate the communication: select the wiimote icon (1 click) and then click on  ”HID service“, the mouse icon. if the connection is capricious, you might have to press simultaneously buttons 1 and 2 again,
If all occurs well, you should see a small animation which means a successful connection.

Interpret the signals:
The Wiimote is now connected, and sends its signal to your PC, but it is not being interpreted yet. This is where GlovePie will be helpful, to convert the signals received and return them to your favorites softwares and games.
Indeed, the software developed by Carl Kenner has the role of converting any type of signal (from a mouse, Joystick, a P5 glove) into another signal (MIDI, variables…) using a simple scripting language and/or a GUI.

Now, start GlovePie (version 0.29 to date). By default, the freeware opens on the empty script editor. Fortunately, there are loads of scripts provided with the install: for example, load WiimoteScripts/WiiMouse 0.1.PIE, and click on RUN, and you can now control your mouse cursor with your Wiimote. Also, you have to try Drummerkit, and then you can play “air battery”

Midiiiiiii !
So, now it gets exciting.. Everything is now ready, the last thing to do is to install MidiYoke (a virtual MIDI port, which emulates a MIDI device to use like a ”bridge” with your midi softwares) then download and launch this Glovepie script, which will finally enable you to get the Wiimote movements to any software supporting midi.

In the latest version beta0.2, you get the  of  X, Y and Z slope value from your Wiimote, which are converted into  #CC values 30, 31 and 32, variables from 0 to 127, which allows you to scratch a video or to fade it up and down by waving your Wiimote in the air. Also you must test it with Ableton, the results are very surprising, especially on the live effects!

As you can see, the buttons are mapped to “midi notes”, and allows you to launch events very simply. You can also send keyboard events instead, or change midi notes values depending on your needs. The script is now comented in english, and I will keep updating it this way.

It’s still a bit basic, and there are many extra things possible, so the next steps will be to use acceleration sensors, use the sensorbar, and also use the Nunchuk (the second gamepad available), and maybe connect more wiimotes for multi-user interaction…
Don’t hesistate to post links of what you achieved with wiimote2midi, and ask for updates or special requests…

————————–
23/02/07 – beta0.1
Wiimote2midi.pie
————————–

————————–
24/02/07 – beta0.2 (comments in english)
Wiimote2midi.pie
————————–

Here’s a short video demo of VJing with a Wiimote:

Other tutorials:
- Wiimote to Midi (PC).
- Wiimote to Midi (PC) french version.
- Wiimote to Midi: VJing video.
- Wiimote to Midi for Ableton Live (PC).
- Wiimote to Midi: Mac & Linux.

La bonne nouvelle, c’est que plutôt que d’utiliser un protocole propriétaire pour transmettre les infos de la Wiimote à la Wii, et ainsi vérrouiller son hardware pour en garder un usage exclusif, Nintendo a pris l’excellente décision (probablement par volonté commerciale) d’utiliser le protocole Bluetooth, standard de communication sur PC et Mac depuis plusieurs années. Ce qui veut dire que l’on peut connecter sans problême une Wiimote à son ordinateur, et en utiliser pleinement les fonctionnalités assez simplement.

- – - – - – - – - – - -

Dans ce Post, nous allons apprendre à connecter une Wiimote à un PC, et transformer les valeurs reçues en signaux MIDI, pour pouvoir contrôler ensuite des logiciels de VJing (comme Arkaos) ou de production/live audio (Ableton pour n’en citer qu’un..).

Matériel necessaire:
- Une Wiimote, bien entendu (environ 40euros, sur internet ou en magasin de jeux vidéos).
- Une clé Bluetooth (si votre ordinateur n’a pas le Bluetooth intégré, une quinzaine d’euros).
- Le logiciel Bluesoleil (shareware, souvent fourni gratuitement avec votre clé Bluetooth).
- Le logiciel GlovePie (freeware).
- MidiYoke (freeware, nécessaire pour utiliser le MIDI).

Connecter votre Wiimote à votre PC:
Une fois votre clé installée, la Wiimote déballée et remplie de piles fraîches:
1 - Lancez maintenant Bluesoleil (une icone grise apparait dans la barre des tâches, puis devient bleue une fois la clé Bluetooth initialisée. Double-cliquez maintenant sur l’icône bleue pour lancer le programme).
2 - Vous devez maintenant mettre votre Wiimote en mode “détection”. Pour cela, pressez simultanément les boutons 1 et 2 de votre télécommande magique (les LEDs se mettent à clignoter).
Dans Bluesoleil, lancer la détection des périphériques en cliquant sur la sphère orange au centre de la fenêtre.
3 - Votre Wiimote à été détectée, et apparait dans Bluesoleil. Il faut maintenant activer la communication, en sélectionnant l’icône wiimote (1 clic) puis en cliquant sur “service HID“, l’icône qui ressemble à une souris. N’hésitez pas à appuyer une seconde fois simultanément sur les boutons 1 et 2 si la connection est capricieuse.
Si tout se passe bien, vous devriez voir une petite animation qui symbolise la connection réussie.

Interpréter les signaux reçus:
La Wiimote est maintenant connectée, et envoie son signal à votre PC, mais il n’est pas encore interprété. C’est maintenant que GlovePie intervient, pour convertir les signaux reçus et les renvoyer à vos applications et jeux favoris.
En effet, le logiciel développé par Carl Kenner a pour mission de convertir tout type de signal (d’une souris, d’un Joystick, d’un gant P5) en un autre signal (MIDI, variables..) à l’aide d’un langage de script simple et/ou d’un GUI.

Lancez donc le logiciel GlovePie (version 0.29 à ce jour). Par défaut, le freeware s’ouvre sur l’éditeur de script vide. Heureusement, il existe quantité de script fournis avec l’install: chargez par exemple WiimoteScripts/WiiMouse 0.1.PIE, et cliquez sur RUN, et vous pouvez maintenant contrôler votre souris grâce à votre Wiimote.. A tester également, Drummerkit, pour faire de l’ “air batterie”

Midiiiiiii !
Bon, maintenant que tout est prêt, il ne nous reste plus qu’à installer MidiYoke (un port MIDI virtuel, qui va simuler un périphérique midi pour faire la passerelle avec vos logiciels midi) puis téléchargez et lancez ce script Glovepie, qui va vous permettre enfin de récupérer les valeurs midi dans vos logiciels compatibles.
Dans cette version beta0.1, vous récupérez les valeur de l’inclinaison X, Y et Z de votre Wiimote, qui sont converties en valeur #CC 30, 31 et 32, variable de 0 à 100, ce qui vous permet maintenant de scratcher une vidéo ou faire des fades en déplacant votre Wiimote dans les airs.. Essayez aussi sur Ableton, les résultats sont assez surprenants sur les effets !

Comme vous pouvez le voir, les boutons sont mappés sur des “midi notes”, et permettent de déclencher des évênements simplement. Une option pour envoyer des évênements clavier est aussi disponible, et n’hésitez pas à modifier les touches, le script est commenté.

Les prochaines étapes dans ce script vont être l’utilisation de l’accélération, de la sensorbar, et du Nunchuk (le second gamepad disponible). Restez dans le coin !

————————–
23/02/07 – beta0.1
Wiimote2midi.pie
————————–

————————–
24/02/07 – beta0.2
Wiimote2midi.pie
————————–

Voici une petite démo vidéo de l’utilisation du script:

Other tutorials:
- Wiimote to Midi (PC).
- Wiimote to Midi (PC) french version.
- Wiimote to Midi: VJing video.
- Wiimote to Midi for Ableton Live (PC).
- Wiimote to Midi: Mac & Linux.