Xbox 360 Wireless Controller

From Kodi
Jump to: navigation, search

1 Xbox 360 Wireless Controller for Windows


The Xbox 360 Wireless Controller for Windows, which is sold by Microsoft with a separate receiver, works with Kodi on Windows XP, Vista, and 7 using standard Microsoft Drivers. The controller, along with the wired edition controller, should be plug-and-play on Windows (tested with Windows 7. Awaiting confirmation on Vista and XP) since Kodi 12 Frodo.

Many other unofficial 360 controller models have been reported as compatible with Kodi and added to the device list. If you run into one that does not work automatically, please use the instructions in the forum thread linked below to report the device name and make it work.

For Linux, there are two options: the built-in Xpad kernel drivers bundled with most Linux distributions or the Xboxdrv userspace drivers package, available here: Homepage and Binaries or Git-Source (or use your package manager). Xpad should work out of the box with no configuration. However, Xboxdrv doesn't map the same way or use the same device name, so if you want to use it with XBMC, use the --mimic-xpad argument. This will cause it to use the same mappings and device names as Xpad, the only currently supported method.

Work is still progressing on Linux support. In particular, use of the 360 triggers in Linux can cause some axes of the thumbsticks to fail until Kodi is restarted. See the Forum link below for more information.

The following gallery shows the function of each button when navigating menus and during video playback.

Attention talk.png See Fix Xbox 360 controller support (keymap xbox 360 controller) forum discussion

2 Keymap values

Valid Microsoft XBOX 360 Controller syntax is <button id="x">action</button> or <axis id="x" limit="y">action</axis>.

Here is a full list of button and axis mappings:


  • 1 - A
  • 2 - B
  • 3 - X
  • 4 - Y
  • 5 - LB
  • 6 - RB
  • 7 - Start
  • 8 - Guide
  • 9 - Left Stick Button
  • 10 - Right Stick Button
  • 11 - D-Pad Up
  • 12 - D-Pad Down
  • 13 - D-Pad Left
  • 14 - D-Pad Right
  • 15 - Back

Axis Mappings:

  • 1 - Left Stick L/R
  • 2 - Left Stick U/D
  • 3 - Left Trigger
  • 4 - Right Stick L/R
  • 5 - Right Stick U/D
  • 6 - Right Trigger


    <joystick name="Xbox 360 Wireless Receiver">
      <altname>Controller (Gamepad for Xbox 360)</altname>
      <altname>Controller (XBOX 360 For Windows)</altname>
      <button id="1">Select</button>
      <button id="2">Back</button>
      <button id="3">FullScreen</button>
      <button id="4">ContextMenu</button>
Personal tools

Wiki help