README.md

September 21, 2025 ยท View on GitHub

XtMapper

XtMapper, a free and open source keymapper.
Play your Android games with keyboard and mouse

About and features

https://xtr126.github.io/XtMapper-docs/guides/about
Watch video on YouTube

Screenshots

Click to expand
image

Development

Build

  • Run ./gradlew assembleDebug or ./gradlew.bat assembleDebug at the base directory of the project

Help and support

To report any bugs to help improve XtMapper please create an issue at https://github.com/Xtr126/XtMapper/issues

To share your thoughts on XtMapper/ ask any questions please create a post at https://github.com/Xtr126/XtMapper/discussions

Using on waydroid

https://xtr126.github.io/XtMapper-docs/waydroid/1-overview/

Credits

@guobao2333 - Chinese translation
@muhammadbahaa2001 - Arabic translation
@KSMaan45 - Punjabi translation

Help us translate on Crowdin or GitHub

And everyone else not mentioned here who took their time reporting bugs and making suggestions.

Open source libraries used:

Some code from the scrcpy project was used for implementing multi-touch support in the keymapper.
Get it on IzzyOnDroid

The source code is licensed under the GPL v3.

XtMapper
Copyright (C) 2022 Xtr126

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; version 3.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License 
along with this program. If not, see https://www.gnu.org/licenses/.

Do not publish unofficial APKs to the play store. It hurts open source projects like ours.