Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/falkern/kbm2joy
A simple tool to convert mouse movements into joystick inputs using a virtual Xbox 360 gamepad.
https://github.com/falkern/kbm2joy
fun gui mouse open-source python software
Last synced: 11 days ago
JSON representation
A simple tool to convert mouse movements into joystick inputs using a virtual Xbox 360 gamepad.
- Host: GitHub
- URL: https://github.com/falkern/kbm2joy
- Owner: Falkern
- License: mit
- Created: 2024-10-18T04:35:35.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-28T22:41:01.000Z (3 months ago)
- Last Synced: 2024-11-24T12:07:20.087Z (2 months ago)
- Topics: fun, gui, mouse, open-source, python, software
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kbm2Joy (works but still under development)
This project provides a simple GUI application to convert mouse movements into joystick inputs using a virtual Xbox 360 gamepad. It is built using Python and leverages the `pyautogui` and `vgamepad` libraries for mouse and gamepad interactions, respectively.
## Disclaimer
Use this project at your own risk. The authors are not responsible for any damage or issues that may arise from using this software. It is not guaranteed to be undetectable by all games, so use it at your own risk.
## Features
- **Mouse to Joystick Mapping**: Converts mouse movements to joystick inputs.
- **Sensitivity Adjustment**: Allows users to adjust the sensitivity of the joystick for both X and Y axes.
- **Deadzone Configuration**: Users can set deadzone values to ignore minor mouse movements.
- **Start/Stop Emulation**: Easily start or stop the emulation with a button click.
## Requirements
- Python 3.x
- `pyautogui` library
- `vgamepad` library
- `tkinter` library (usually included with Python)
## Installation
1. Clone the repository:
```sh
git clone https://github.com/yourusername/kbm2joy.git
cd kbm2joy
```
2. Install the required libraries:
```sh
pip install pyautogui vgamepad
```
## Usage
1. Run the `main.py` script:
```sh
python main.py
```
2. Use the GUI to adjust sensitivity and deadzone settings as needed.
3. Click the "Start Emulation" button to begin converting mouse movements to joystick inputs. Click the button again to stop the emulation.
## Code Overview
The main script initializes a virtual Xbox 360 gamepad and sets up a Tkinter GUI for user interaction. The core functionality includes:
- **apply_deadzone**: Applies deadzone to joystick values.
- **map_mouse_to_joystick**: Maps mouse movements to joystick inputs.
- **toggle_emulation**: Starts or stops the emulation.
- **update_sensitivity_x/y**: Updates sensitivity settings.
- **update_deadzone_x/y**: Updates deadzone settings.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contributing
Contributions are welcome! Please fork the repository and submit a pull request for any improvements or bug fixes.
## Contact
For any questions or suggestions, please open an issue on the GitHub repository.