CWiid Wiimote Interface

QUICKSTART

sudo apt-get install bison flex libgtk2.0-dev autotools-dev automake libbluetooth-dev
cd cwiid
aclocal
autoconf
./configure --with-cwiid-config-dir=/etc/cwiid/
make
sudo make install
sudo modprobe uinput
wminput -c <key_bind_file>

You can find key bind files at /etc/cwiid/wminput/

DESCRIPTION

The CWiid package contains the following parts:

libcwiid - wiimote API.
cwiid module - python interface to libcwiid
wmgui - GTK gui to the wiimote.
wminput - an event/joystick/mouse driver for the wiimote.
lswm - list wiimote devices (in the spirit of ls{,pci,usb}, etc.
wmdemo - a minimal demonstration of the libwiimote API. (not installed)

REQUIREMENTS

awk, bison, flex, bluez-libs, gtk+-2 dev libs, python 2.4 or greater, python dev for python module, uinput kernel support, kernel sources

INSTALLATION

If installing from git, run the following commands. Otherwise, or if you aren't sure, ignore them.

aclocal
autoconf

All users should then run:

./configure
make
sudo make install

To install global configuration files to the more familiar /etc rather than /usr/etc or /usr/local/etc, execute configure with --sysconfdir=/etc.

While CWiid is still in the early development stages, installation directories and filenames are changed more often than in a mature, stable package. In order to prevent the collection of obselete directories and files, it is recommended that you run 'make uninstall && make uninstall_config' from your current CWiid source directory before installing a new one. Files are currently installed to the following directories: /usr/local/{bin,etc,lib,lib/cwiid,lib/python2.X/site-packages,share/doc,share/man}. Recently, but no longer, used directories include /usr/share/CWiid - this directory may be deleted.

Many distributions do not have /usr/local/lib in the library search path, and on many of these same distributions, the library installation directory (as determined by autoconf) is /usr/local/lib, creating a problem when you try to run programs depending on libraries installed there. There are two clean ways to fix this:

Add a --prefix=/usr argument to ./configure
Add /usr/local/lib to /etc/ld.so.conf, then run ldconfig.

I prefer the second method since it keeps local software in the local directory where it should be, and it fixes the problem for every package using /usr/local/lib, not just CWiid. Until someone offers a convincing argument for the omission of /usr/local/lib from /etc/ld.so.conf, I consider this to be a distribution bug, and method #2 above is the fix.

Please report any compilation errors at http://cwiid.org.

EXECUTION

wmgui [-h] [bdaddr] wminput [-h] [-c config] [bdaddr]