2012-10-20 11:24:23 +02:00
|
|
|
Improved XBMC Wiimote Gateway
|
|
|
|
|
=============================
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
An XBMC event client that receives input from a Wii remote via bluetooth
|
|
|
|
|
and feeds them to XBMC.
|
|
|
|
|
|
2012-10-20 11:24:23 +02:00
|
|
|
While XBMC comes with a Wii remote event client already (`xbmc-wiiremote`),
|
|
|
|
|
this project aims to improve upon it by adding some additional features
|
|
|
|
|
such as automatic disconnect, by having better error handling and to be
|
|
|
|
|
more hackable by using the Python bindings.
|
|
|
|
|
|
2011-12-11 21:36:59 +01:00
|
|
|
Features
|
|
|
|
|
--------
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
* Automatic disconnect after a period of disuse
|
|
|
|
|
* On connect…
|
2011-12-11 21:36:59 +01:00
|
|
|
* notifications in XBMC,
|
|
|
|
|
* rumble, and
|
|
|
|
|
* battery status report
|
2011-12-10 21:55:00 +01:00
|
|
|
* Supports key repeating when holding a button down
|
|
|
|
|
* Rudimentary error handling
|
|
|
|
|
* Usage of a specific Wii remote to be able to pair quickly
|
2011-12-11 21:36:59 +01:00
|
|
|
* Uses the official XBMC [EventServer API](http://wiki.xbmc.org/?title=EventServer#Event_Clients_and_the_EventServer)
|
|
|
|
|
* Uses the default [Wii remote keymap](https://github.com/xbmc/xbmc/blob/master/system/keymaps/joystick.WiiRemote.xml)
|
|
|
|
|
shipped with XBMC
|
2011-12-10 21:55:00 +01:00
|
|
|
|
2011-12-11 21:36:59 +01:00
|
|
|
Requirements
|
|
|
|
|
------------
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
XBMC Wiimote Gateway is an XBMC event client, so it needs:
|
|
|
|
|
|
|
|
|
|
* XBMC Dharma (>= 10.1), with
|
2011-12-11 21:36:59 +01:00
|
|
|
* XBMC Event Client Python bindings
|
2011-12-10 21:55:00 +01:00
|
|
|
* Python (>= 2.6), with
|
2011-12-11 21:36:59 +01:00
|
|
|
* Python CWIID bindings (>= 0.6)
|
2011-12-10 21:55:00 +01:00
|
|
|
* Bluez (>= 4.96)
|
|
|
|
|
|
|
|
|
|
and of course a working bluetooth controller.
|
|
|
|
|
|
2011-12-11 21:36:59 +01:00
|
|
|
Installation & Use
|
|
|
|
|
------------------
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
The script itself, xbmc-wiimote, can be put anywhere. Preferably, put it
|
|
|
|
|
somewhere that is in the system's/in your path.
|
|
|
|
|
|
|
|
|
|
Then, run:
|
|
|
|
|
|
2012-10-20 11:24:23 +02:00
|
|
|
$ xbmc-wiimote -b <Wii remote bluetooth address>
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
You should see a notification pop up in XBMC that tells you that the
|
|
|
|
|
XBMC Wiimote Gateway has connected.
|
|
|
|
|
|
|
|
|
|
If you don't know the bluetooth address of your Wii remote, run
|
|
|
|
|
|
2011-12-11 21:39:32 +01:00
|
|
|
$ hcitool scan
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
and quickly press 1+2 on the Wii remote to find the address
|
|
|
|
|
|
2011-12-11 21:36:59 +01:00
|
|
|
License
|
|
|
|
|
-------
|
2011-12-10 21:55:00 +01:00
|
|
|
|
|
|
|
|
XBMC Wiimote Gateway free software: you can redistribute it and/or modify
|
|
|
|
|
it under the terms of the GNU General Public License as published by the
|
|
|
|
|
Free Software Foundation, either version 3 of the License, or (at your
|
|
|
|
|
option) any later version.
|
|
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT
|
|
|
|
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
|
|
|
|
more details.
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License along
|
|
|
|
|
with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
2011-12-11 21:36:59 +01:00
|
|
|
*N.B.* The source code of this program includes code from
|
2011-12-10 21:55:00 +01:00
|
|
|
http://code.activestate.com/recipes/577407/ which is licensed under the
|
|
|
|
|
Apache License 2.0, see also: http://www.apache.org/licenses/LICENSE-2.0.html
|
