# atar-axis/xpadneo

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/atar-axis-xpadneo).**

2,539 stars · 133 forks · C · gpl-3.0

## Links

- GitHub: https://github.com/atar-axis/xpadneo
- Homepage: https://atar-axis.github.io/xpadneo/
- awesome-repositories: https://awesome-repositories.com/repository/atar-axis-xpadneo.md

## Topics

`dkms` `dkms-packages` `gamepad` `hid` `linux-driver` `linux-drivers` `xbox` `xbox-controller` `xbox-one` `xpad` `xpadneo`

## Description

xpadneo is a Linux kernel driver that enables Bluetooth Low Energy connectivity and input support for wireless Xbox gamepads. It functions as a low-level driver for managing wireless controller connections and report descriptors via the Bluetooth protocol.

The project includes an input mapper to override default button mappings and disable kernel dead zones, providing raw axis data for high-precision movement. It also features a haptic controller for managing rumble intensity and high-frequency trigger force feedback, alongside a gamepad mouse emulator that converts stick and button inputs into mouse and keyboard events.

The driver covers broader capability areas including gamepad input mapping, controller profile switching, and battery level monitoring. It also provides utilities for hardware communication debugging by capturing kernel logs and report descriptors.

## Tags

### User Interface & Experience

- [Peripheral Input Drivers](https://awesome-repositories.com/f/user-interface-experience/input-controls/peripheral-input-drivers.md) — Functions as a kernel-level driver that translates raw Bluetooth gamepad packets into standardized system input events.
- [Native Controller Integrators](https://awesome-repositories.com/f/user-interface-experience/form-and-input-management/input-handling/native-input-mappers/native-controller-integrators.md) — Integrates wireless Xbox gamepads into the Linux system via Bluetooth for authentic input.
- [Console Input Mappers](https://awesome-repositories.com/f/user-interface-experience/input-controls/peripheral-input-drivers/console-input-mappers.md) — Configures Xbox controllers to provide raw axis data and custom button mappings for gaming.
- [Gamepad Mappers](https://awesome-repositories.com/f/user-interface-experience/input-device-detection/embedded-input-controllers/gamepad-mappers.md) — Standardizes button mappings and driver settings to ensure consistent controller behavior on Linux.
- [Haptic Feedback Controllers](https://awesome-repositories.com/f/user-interface-experience/haptic-feedback-controllers.md) — Manages rumble intensity and trigger force feedback for smooth tactile responses. ([source](https://atar-axis.github.io/xpadneo/))
- [High-Frequency Streaming](https://awesome-repositories.com/f/user-interface-experience/haptic-feedback-controllers/high-frequency-streaming.md) — Provides high-frequency streaming of rumble and trigger force feedback to ensure smooth tactile responses.
- [Axis Precision Optimization](https://awesome-repositories.com/f/user-interface-experience/input-device-detection/embedded-input-controllers/gamepad-mappers/axis-precision-optimization.md) — Removes kernel dead zones to provide high-precision raw axis data for games and simulators.

### Development Tools & Productivity

- [Input Mapping Layers](https://awesome-repositories.com/f/development-tools-productivity/input-mapping-layers.md) — Standardizes button and axis mappings across software layers to support specialized inputs. ([source](https://atar-axis.github.io/xpadneo/))

### Hardware & IoT

- [Bluetooth Connectivity](https://awesome-repositories.com/f/hardware-iot/bluetooth-connectivity.md) — Implements Bluetooth Low Energy connectivity for maintaining stable wireless communication between Xbox controllers and the host.
- [Bluetooth Gamepad Drivers](https://awesome-repositories.com/f/hardware-iot/bluetooth-gamepad-drivers.md) — Provides a low-level driver for managing wireless controller connections and report descriptors via Bluetooth.
- [Gamepad-to-Keyboard Mappings](https://awesome-repositories.com/f/hardware-iot/gamepad-to-keyboard-mappings.md) — Converts gamepad stick and button inputs into mouse and keyboard events for system navigation.
- [Analog Input Precision](https://awesome-repositories.com/f/hardware-iot/pointer-precision-modes/analog-input-precision.md) — Disables kernel dead zones to provide raw axis data for high-precision movement in games. ([source](https://atar-axis.github.io/xpadneo/))

### Operating Systems & Systems Programming

- [Linux Gamepad Drivers](https://awesome-repositories.com/f/operating-systems-systems-programming/linux-gamepad-drivers.md) — Provides a Linux kernel driver for Bluetooth Low Energy connectivity and input support for Xbox gamepads.
- [Gamepad-to-Mouse Emulations](https://awesome-repositories.com/f/operating-systems-systems-programming/gamepad-to-mouse-emulations.md) — Converts gamepad stick and button movements into mouse and keyboard events for system navigation. ([source](https://atar-axis.github.io/xpadneo/))
- [Raw Input Passthroughs](https://awesome-repositories.com/f/operating-systems-systems-programming/raw-input-passthroughs.md) — Bypasses kernel-level dead zone filtering to deliver unscaled analog input directly to the user-space application.