KeyMouse2Pad

SPDX-License-Identifier: GPL-3.0-or-later

English | 한국어

KeyMouse2Pad converts keyboard and mouse input into gamepad controls on Windows. It is built for players who want a lightweight keyboard/mouse-to-controller converter with editable mappings and a simple GUI.

Status

• Windows-focused GUI application.
• System-wide keyboard and mouse capture on Windows.
• Xbox 360 controller output through the vgamepad / ViGEm stack when available.
• Editable keyboard and mouse mappings saved locally.
• C++ mapping engine tests for the portable core.
• Experimental Windows HID driver boundary for future kernel-driver work.

This project is not a signed production kernel driver. Some runtime features may need administrator privileges depending on the target game or application.

Download

Stable builds are published from GitHub Releases once a version tag is created. For development builds, run from source or build the executable locally.

Run From Source

Windows:

run_gui.bat

Linux/WSL can run the mapping tests, but the actual input capture and controller output features are Windows-only.

Build

Build the Windows executable:

build_exe.bat

The output is:

dist\KeyMouse2Pad.exe

Run local checks:

make test
make gui

On Windows without make, run the GUI smoke test directly:

py -3 gui\converter_gui.py --self-test

Documentation

• Windows setup
• Architecture
• Branching
• Korean Windows setup

Contributing

Keep contributions small and practical. Open an issue for behavior changes, send a PR for focused fixes, and let CI handle the repetitive checks.

See CONTRIBUTING.md.

License

KeyMouse2Pad is licensed under the GNU General Public License v3.0 or later. See LICENSE.

Third-party runtime notices are listed in THIRD_PARTY_NOTICES.md.