Find a file
Ingo Ruhnke 575170d891 Use session dbus even for user root
This should save us from having to deal with busconfig, see:

https://github.com/xboxdrv/xboxdrv/issues/42

Fixes #42
2015-11-06 17:29:32 +01:00
doc Changed link to SDL-envvar documentation 2013-09-23 18:36:17 +02:00
examples added missing analog clicks and guide button. 2013-11-30 14:42:59 +01:00
hal Some more stuff 2009-02-19 16:56:48 +01:00
runxboxdrv New version of runxboxdrv 2011-01-28 17:27:32 +01:00
src Use session dbus even for user root 2015-11-06 17:29:32 +01:00
test Replaced grumbel@gmx.de with grumbel@gmail.com 2015-06-25 20:25:24 +02:00
tools Replaced grumbel@gmx.de with grumbel@gmail.com 2015-06-25 20:25:24 +02:00
.gitignore More .gitignore 2015-06-20 13:36:00 +02:00
.travis.yml Added 'make install' to travis 2015-10-26 03:47:56 +01:00
AUTHORS Some more chatpad work 2011-01-02 19:12:32 +01:00
chatpad.xkb Use currency symbol for Microsoft Points symbol (see Wikipedia on currency symbol) 2011-01-10 18:32:04 +01:00
COPYING - added copying 2008-04-11 00:06:07 +02:00
Makefile Replaced grumbel@gmx.de with grumbel@gmail.com 2015-06-25 20:25:24 +02:00
NEWS Updated NEWS 2015-10-28 11:34:33 +01:00
PROTOCOL Added some info for the chatpad 2013-01-05 21:51:17 +01:00
README.md Converted README to markdown 2015-06-20 11:13:39 +02:00
SConstruct Merge pull request #125 from tgurr/cross_pkg-config 2015-05-05 03:38:00 +02:00
TODO TODO updates 2011-08-23 11:51:42 +02:00
VERSION Incremented version number 2015-10-28 11:28:09 +01:00
xboxdrvctl Replaced grumbel@gmx.de with grumbel@gmail.com 2015-06-25 20:25:24 +02:00

Xbox/Xbox360 USB Gamepad Driver for Userspace

Xboxdrv 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.

Some basic support for the Xbox360 Chatpad on USB controller is provided, Chatpad on wireless ones is not supported. The headset is not supported, but you can dump raw data from it.

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:

The development version can be optained via:

Compilation

Required libraries and tools:

  • g++ - GNU C++ Compiler
  • libusb-1.0
  • pkg-config
  • libudev
  • boost
  • scons
  • uinput (userspace input kernel module)
  • git (only to download the development version)
  • X11
  • libdbus
  • glib

Once everything installed, you can compile by typing:

scons

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

sudo apt-get install \
 g++ \
 libboost1.42-dev \
 scons \
 pkg-config \
 libusb-1.0-0-dev \
 git-core \
 libx11-dev \
 libudev-dev \
 x11proto-core-dev \
 libdbus-glib-1-dev

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