This project provides integration between Xbox One and Xbox Series controllers with Mac computers. It allows you to use your Xbox controller as a mouse and keyboard input device on your Mac.
- Cursor control: Use the left joystick of your Xbox controller to move the mouse cursor on your Mac screen.
- Mouse clicks: Use the Xbox controller buttons to simulate left and right mouse button clicks.
- Scroll functionality: Utilize the right joystick of your Xbox controller to scroll vertically and horizontally.
- Button mapping: Customize the button assignments to match your preferences using a JSON configuration file.
- Debounce handling: Prevent accidental button triggers with a configurable debounce delay.
- Smoothing and sensitivity control: Apply smoothing algorithms and adjust sensitivity to fine-tune the controller's responsiveness.
- A controller supported with
PyGame
Python 3
Pygame library
pynput library
Build & Run Or download a release
- Connect your Xbox controller to your Mac.
- Install the required Python libraries: Pygame and pynput.
- Download or clone this repository:
git clone https://github.com/JeriahN/Xbox-Mac-Integration.git
. - Customize the button mappings in the
button_map.json
file if desired. - Run the
xbxmacintegration.py
script. - Enjoy using your Xbox controller as a mouse and keyboard on your Mac!
This project is licensed under the MIT License.
Feel free to contribute by submitting bug reports, feature requests, or pull requests. Any feedback and contributions are greatly appreciated!