You are here: Start Linux and Computers Wii OSC bridge in Python
Wii OSC bridge in Python PDF Print E-mail
Written by Andreas Böhler   
Sunday, 24 May 2009 08:38

For a project at university we needed a way to communicate with various Nintendo Wii devices through Matlab. We found two projects dealing with Matlab and Nintendo-Devices, fWIIne and WiiLab. Unfortunately, there were some drawbacks: Both work only on Windows XP with Matlab, but not on Linux and MacOS. Therefore, we decided to do our own implementation in Python.


I implemented two Python scripts, a backend and a frontend. The frontend is a simple OSC server that waits for connections from Matlab or whatever OSC capable application and launches the backend as desired. The backend itself connects to the Nintendo devices, receives data and sends them via OSC. One backend for each device is launched (the underlying Bluetooth-Framework on OS X does not support threading). 

Prerequisites and Limitations

The WiiMote, Nunchuk (even Wireless Nunchuks, at least the Datel Duo FX and Nyko Kama), Classic Controller (only tested on a Datel brand) and the BalanceBoard are supported at the moment. 

Windows XP, Mac OS X and Linux are supported. However, you need different other libraries in order to function properly. 

Windows XP

You need to have the WIDCOMM stack installed, other stacks simply won't work. Additionally, you need Python, pyliblo and pybluez installed.

Mac OS X

You need to install XCode (for compiling lightblue and pyliblo) lightblue (as root), pyliblo and OSCulator (and launch it once to install the Kernel Driver).


Install some packages through your distribution's package manager: python-bluez, python-liblo and you are done. 


Anonymous access to our mercurial repository is possible by either browsing and downloading online at or by directly cloning the source via the 'hg' command:

hg clone wiipy

Then, simply launch and initiate a connection. 

HowTo and Documentation

See the attached HowTo for installation instructions. Additional documentation is only available in German at the moment, again, see attachments.

Download this file (osc_protokoll.pdf)osc_protokoll.pdf[Protokollbeschreibung OSC (German only!)]235 Kb
Download this file (wiipy_howto_en.pdf)wiipy_howto_en.pdf[WiiPy HowTo]270 Kb
Comments (0)
Write comment
Your Contact Details:
[b] [i] [u] [url] [quote] [code] [img]   
Please input the anti-spam code that you can read in the image.
Last Updated on Tuesday, 04 August 2009 13:39
Template is Powered by © 2008 | CSS 2.1 | XHTML 1.0