Warning

This project is archived. A 1.0.4 (or 26.1) release was planned at one point, but integrating ADB properly and getting everything working reliably in Python turned out to be a lot more complicated than expected, so I'm archiving it for now rather than leave it half finished. If there's ever a future release, I'd probably unarchive this repo and pick it back up. For now, the last known working version is from 2024, back when I first learnt programming.

About Wmapper 📌

Welcome to Wmapper 🫶!
This project aims to ease the process of keymapping throughout Windows with a simple and intuitive GUI.

Heads up: the last known working version (2024) doesn't have any drag and drop functionality. You just select a window and a keymap location, and it simulates a swipe or click at that spot. It's a bit of a hassle to set up compared to what was planned, but it works.

Wmapper's main purpose is to help keymapping in apps like:

• Google Play Games
• Microsoft WSA

What Wmapper Offers:

• 🚀 Easy Keymapping: An intuitive GUI to keymap your window.
• 🤝 Community Help: Join a growing community of contributors to download and share keymap configurations.
• 📚 Accessibility: Comprehensive documentation and support for Wmapper versions above 1.0.2.

Features of Wmapper 🚀

• 🎮 Simple Keymapping: Select a window and a location, and simulate a swipe or click there.
• 🔒 Cursor Lock: Lock the cursor inside specific regions for enhanced precision whilst gaming in Android games.
• 🌐 Multi-Window Support: Fully supports keymapping for multiple windows to make keymapping easier.
• 🧑‍🤝‍🧑 Community-driven: Engage with a growing community to share keymaps and configurations.

How to Run Wmapper ▶️

Running Wmapper is simple, just pick the executable that matches the game you want to play:

• swipingkeymapper.exe: use this if your game relies on swipe gestures.
• keymapper.exe: use this for games that only need standard tap/click keymapping.

How to Build Wmapper 🔨

Building Wmapper from source is a straightforward process! Follow the steps below to set up Wmapper on your local machine.

Prerequisites:

Before starting, make sure you have the following installed:

• Python 3.7 or higher
• pip (Python's package installer)
• Git (for cloning the repository)

Steps to Build Wmapper:

1. Clone the Repository
   First, clone the Wmapper repository to your local machine. Open a terminal (or command prompt) and run:

   git clone https://github.com/your-username/Wmapper.git

2. Get the Source Files
   Once cloned, you'll have all the source files on your machine. See the How to Run Wmapper section above for how to use them.