https://github.com/tanikai/controller-randomizer
Randomize the button mapping of your XInput controller.
https://github.com/tanikai/controller-randomizer
gamepad windows xinput
Last synced: 27 days ago
JSON representation
Randomize the button mapping of your XInput controller.
- Host: GitHub
- URL: https://github.com/tanikai/controller-randomizer
- Owner: Tanikai
- Created: 2023-03-14T20:44:58.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-20T17:57:11.000Z (about 3 years ago)
- Last Synced: 2025-10-09T11:54:48.098Z (8 months ago)
- Topics: gamepad, windows, xinput
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Controller-Randomizer
## About
This project reads the button presses of an XInput controller, maps it to other buttons defined in a randomized keymap,
and sends the mapped inputs to a virtual controller. The virtual controller can be used in your favorite game for extra
fun and confusion during your gameplay.
## Requirements
- Windows (due to XInput)
- Python 3 (tested with Python 3.10)
## Installation
During installation of the requirements, a wizard for the *ViGEmBus* driver installation will open.
```shell
git clone https://github.com/Tanikai/controller-randomizer.git
cd controller-randomizer
pip install -r requirements.txt
```
## Usage
Run the randomizer with:
```shell
python main_gui.py
```
Your input controller has to be connected as Player 1.
## Contact
- **Kai Anter** - [GitHub](https://github.com/Tanikai) - [Mastodon](https://hachyderm.io/@tanikai)