Find a file
2010-12-10 17:56:20 +01:00
chatpad Some more chatpad related tools 2010-11-24 07:02:29 +01:00
contrib hal daemon from Thomas Debouverie <debouverie_thomas@yahoo.fr> 2009-02-19 14:10:06 +01:00
directx directX experimentation 2008-06-12 17:06:11 +02:00
doc Updated documentation for --evdev-absmap 2010-12-09 12:53:48 +01:00
examples Added some example config files 2010-08-09 18:33:52 +02:00
hal Some more stuff 2009-02-19 16:56:48 +01:00
kernel Some more work on ini file parsing and refactoring command line parsing 2010-08-09 17:38:17 +02:00
runxboxdrv Added latest version of runxboxdrv from Michael Rans <rans@email.com> 2010-08-05 21:21:37 +02:00
src Moved addition of extra events on devices to LinuxUinput, added extra events for joystick devices 2010-12-09 15:53:59 +01:00
tools Moved xboxdrv-daemon to top level dir 2010-05-07 02:46:36 +02:00
.gitignore Some more git ignore 2009-07-29 17:08:34 +02:00
AUTHORS Docu updates 2008-11-06 15:41:12 +01:00
COPYING - added copying 2008-04-11 00:06:07 +02:00
Makefile Added a Makefile to replace install.sh 2010-05-14 04:23:02 +02:00
NEWS Added REL_#, ABS_#, KEY_# syntax 2010-05-31 01:56:57 +02:00
PROTOCOL Some more work on ini file parsing and refactoring command line parsing 2010-08-09 17:38:17 +02:00
README Fixed install instructions, replaced % prompt with $ 2010-06-02 19:54:33 +02:00
SConstruct Switched to Glob() building instead of listing all the files 2010-05-30 00:16:18 +02:00
TODO Some more work on ini file parsing and refactoring command line parsing 2010-08-09 17:38:17 +02:00
VERSION Added -d, --detach-kernel-driver option 2010-05-30 14:49:32 +02:00
xboxdrv-daemon Documented --ui-buttonmap A={deviceid}-BTN_A 2010-05-19 17:43:12 +02:00
xboxdrv-ps3 Added simple startup script for PS3 controller 2010-12-10 17:56:20 +01:00

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

[[ Xbox/Xbox360 USB Gamepad Driver for Userspace ]]
===================================================

This is a Xbox/Xbox360 gamepad driver for Linux that works in
userspace. It is an alternative to the xpad kernel driver and has
support for Xbox1 gamepads, Xbox360 USB gamepads and Xbox360 wireless
gamepads. The Xbox360 guitar and some Xbox1 dancemats might work too.
The Xbox 360 racing wheel is not supported, but shouldn't be to hard
to add if somebody is interested.

The Xbox360 chatpad does currently not work and the headset does
neither. There has been some work on reverse enginiering, but no
usable results.

This driver is only of interest if the xpad kernel driver doesn't work
for you or if you want more configurabity. If the xpad kernel driver
works for you there is no need to try this driver.

Newest version of the driver can be found at:

 * http://pingus.seul.org/~grumbel/xboxdrv/

The development version can be optained via:

 * git clone http://pingus.seul.org/~grumbel/xboxdrv.git


[[ Compilation ]]
-----------------

Required libraries and tools:

 * g++ - GNU C++ Compiler
 * libusb
 * boost
 * scons
 * uinput (userspace input kernel module)
 * git (only to download the development version)
 * X11
 * python-dbus (for xboxdrv-daemon.py)

Once everything installed, you can compile by typing:

 $ scons

On Ubuntu 10.04 you can install all the required libraries via:

 $ sudo apt-get install \
     g++ \
     libboost1.40-dev \
     libboost-thread1.40-dev \
     scons \
     libusb-dev \
     git-core \
     libx11-dev \
     x11proto-core-dev \
     python-dbus

To load the uinput kernel module automatically on boot add it
/etc/modules, to load it manually type:

 $ sudo modprobe uinput

On other distributions exact install instructions might be
slightly different.


[[ Installation ]]
------------------

Once the compilation process is complete you can install xboxdrv with:

 $ make install

You can also change the install PREFIX and DESTDIR as usual with:

 $ make install PREFIX=/usr DESTDIR=/tmp

Note that there is no need to install xboxdrv, you can run it directly
from the source directory if you prefer.


[[ Running ]]
-------------

Extensive documentation on running xboxdrv can be found in the RUNNING
XBOXDRV section of the xboxdrv manpage. When you haven't installed
xboxdrv the man page can be found in doc/xboxdrv.1 and be read with:

 $ man -l doc/xboxdrv.1

Documentation on xboxdrv-daemon, a daemon that will automatically
launch xboxdrv when a pad is plugged in can be read via:

 $ man -l doc/xboxdrv-daemon.1


# EOF #