Fellow GitHub user restitux and I have created a python script and a c++ excecutable which map Wii guitar inputs to Xbox 360 controller events when connected to a Dolphinbar or via Bluetooth. These are separate scripts and are not meant to be ran together. The reason we chose to convert to Xbox 360 events was because Clone Hero has built-in default controls for it.
The scripts use Dolphinbar or Bluetooth receivers to take Wiimote HID events and emit them via a uinput virtual gamepad which mimics an Xbox 360 controller. These scripts serve as a replacement for WiitarThing on linux.
The python script requires the python-uinput
and pyhidapi modules.
The c++ script requires udev for uinput and hidapi to access HID devices. If you want to compile the script yourself, know that it requires c++17 or above to compile. Both scripts will either require that you run them as root or that your user account have read/write access to /dev/hidrawX files and /dev/uinput.
Thanks to WiiBrew for their extensive documentation on the Wiimote protocols.
Name inspired by the awesome WiitarThing, which solves this problem for Windows.
This script works almost exactly like WiitarThing with a few exceptions.
- There is no driver to install.
- This script only supports original Wiimotes and guitars as of May 24, 2022.
- Multiplayer and the joystick not supported as of yet.
- There is a special method you need to use to connect the virtual controller to Clone Hero instead of the wiimote itself.
In order to assign the virtual controller to Clone Hero, you first hold down the A button on the wiimote, and then press the Assign Controller button in Clone Hero. It should now say that a controller named "Xbox 360 Controller" is bound to the player. If you don't do this, it will assign the wiimote itself, which will not work.
- Multiplayer support
- Joystick support
- Support for drums