You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This page serves to answer frequently asked questions about Key Mapper, and help solve any problems you may be facing.
2
-
See the [Quick Start Guide](quick-start.md) for more general help with using Key Mapper.
3
-
4
-
## "Can I remap joysticks/dpad/mouse buttons/mouse motion?"
5
-
6
-
No. Here is why:
7
-
8
-
Joysticks are complicated to remap because they are axes, so their inputs are a range depending on how much you press the stick. It would be a lot of work to integrate them into Key Mapper. Currently, the developer cannot implement this feature. See [here](https://github.com/keymapperorg/KeyMapper/blob/master/README.md) for more information. <!--- The developer has found a way that might be able to remap them. Therefore, you can consider this a planned feature. --->
9
-
<!--- as of end of 2022, early 2023, Key Mapper is no longer in development, and users should not be expecting features that will not come to fruition. --->
10
-
11
-
The D-pad is interpreted differently by Android to other keys. That makes it hard to remap. However, the developer has found a way that might be able to remap them. Therefore, you can consider this a planned feature.
12
-
13
-
Mouse buttons are not possible to remap with an accessibility service. There will never be support for them in this app. If other apps can do it, they do not work the same way Key Mapper does. If you want to remap mouse buttons, do not use Key Mapper.
1
+
!!! discord "Want to ask for help?"
2
+
If you've already tried troubleshooting and the tutorials aren't enough, come and ask for help in our [support server.](http://keymapper.club)
14
3
15
-
Remapping the movement of the mouse isn't possible on unrooted Android. The developer doesn't know of a way to do this.
4
+
This page serves to answer frequently asked questions about Key Mapper, and help solve any problems you may be facing.
5
+
See the [Tutorials](tutorials-index.md) for more general help with using Key Mapper.
@@ -28,13 +18,20 @@ This is important for everyone to do if you are experiencing an issue with the a
28
18
If you have tried BOTH steps and Key Mapper still stops working randomly, consider how you are using the app. If you have low-end hardware, and are playing a game while using repeating key maps, it's probably not a bug. It's probably just too much for your device.
29
19
If you think you are using Key Mapper in a reasonable way and still experience random crashes, ask about it in [the discord server.](http://keymapper.club)
30
20
21
+
## "Can I remap joysticks or mouse buttons?"
22
+
23
+
No. Here is why:
24
+
25
+
Joysticks are complicated to remap because they are axes, so their inputs are a range depending on how much you press the stick. It would be a lot of work to integrate them into Key Mapper.
26
+
27
+
Mouse buttons are not possible to remap with an accessibility service. There will never be support for them in this app. If other apps can do it, they do not work the same way Key Mapper does. If you want to remap mouse buttons, do not use Key Mapper.
28
+
31
29
## "How do I change the keyboard?"
32
30
33
31
There are multiple ways to do this.
34
32
35
33
- Tap the keyboard button at the bottom of your display when you are typing something. Not all devices have this and some devices have this feature hidden behind a setting somewhere.
36
34
- Tap the notification that allows you to change the keyboard when you are typing something. Not all devices have this.
37
-
- Open Key Mapper and tap "show input method picker" in the menu :material-menu:.
38
35
39
36
!!! tip
40
37
If you want to switch between one of the Key Mapper keyboards and a normal keyboard when a device, such as a keyboard or game controller, connects/disconnects then Key Mapper can do this for you automatically. Set it up [here](user-guide/settings.md#automatically-change-the-on-screen-keyboard-when-a-device-connectsdisconnects).
@@ -44,7 +41,7 @@ There are multiple ways to do this.
44
41
Key Mapper Basic Input Method (the keyboard built-in to the app) has no GUI/buttons. You can install the [Key Mapper GUI Keyboard](https://play.google.com/store/apps/details?id=io.github.sds100.keymapper.inputmethod.latin) to get a proper keyboard that can also perform Key Mapper actions.
45
42
46
43
## "Why don't my volume buttons work when I press them?"
47
-
Give the app Do Not Disturb access in your device settings. At the top of the homescreen in the Key Mapper app there is a "Fix" button to do this.
44
+
Give the app Do Not Disturb access in your device settings. At the top of the home screen in the Key Mapper app there is a "Fix" button to do this.
48
45
49
46
## "Why aren't the buttons on my Bluetooth device detected?"
50
47
Many Bluetooth devices (like headphones) aren't supported by Key Mapper out of the box. Bluetooth keyboards work most of the time. If you are willing and able to do some simple debugging, perhaps by installing utility apps or using ADB, [join the Discord server](http://keymapper.club) and we will try our best to get it working for you.
@@ -62,75 +59,28 @@ If you *really* want to open the app in DeX, you can put DeX in developer mode:
62
59
## "Why doesn't the app uninstall?"
63
60
You have probably enabled the app's device administrator in your device's settings. To uninstall the app, you must turn it off. The location of the device admin settings page varies on devices but on skins close to stock-Android it is under "Security" -> "Device admin apps". If you need help, [ask in the Discord server.](http://keymapper.club)
64
61
65
-
## "Why can't I remap some of my Joy Con buttons?"
66
-
Not all the Joy Con buttons are visible to accessibility services. There isn't anything the developer can do.
67
-
68
-
I tested the app on SwitchRoot Android and this is what works...
69
-
70
-
**Working:**
71
-
72
-
* ZL (Button L2)
73
-
* L (Button L1)
74
-
*\- (Select)
75
-
*\+ (Start)
76
-
* Left analog stick button (unknown keycode 0)
77
-
* ZR (Button R2)
78
-
* R (Button R1)
79
-
* X (Button X)
80
-
* Y (Button Y)
81
-
* B (Button B)
82
-
* A (Button A)
83
-
* Home (Home)
84
-
* Volume up (Vol up)
85
-
* Volume down (Vol down)
86
-
87
-
**Not working:**
88
-
89
-
* Screenshot button
90
-
* All D-Pad buttons (used by OS)
91
-
* Both analog sticks (used by OS)
92
-
* Right analog stick button
93
-
* SR and SL (left joycon)
94
-
* SR and SL (right joycon)
95
-
* Power button
96
-
97
-
## "Add on-screen buttons to Key Mapper"
98
-
99
-
On-screen buttons are not a planned feature. In the near future, it will not be possible for apps to do this, even if some apps can right now. There is currently no work being done on adding on-screen buttons.
100
-
101
-
Google is removing the ability for apps to draw overlays over other apps. This is called the "system alert window" feature in the developer world. Android Go devices already can't do this.
102
-
103
62
## "A game doesn't detect my key maps"
104
63
105
-
Unsupported games
106
-
- Fortnite
107
-
108
64
There is no guarantee that your key maps will work in games. The app isn't designed for it.
109
65
Follow this guide if you are remapping buttons on a game controller to different buttons on a game controller.
110
66
111
67
- Connect your controller to your device.
112
68
- Create a trigger for whatever button you want to remap.
113
69
- Press "Add Action" and create a "Key Event" action by going to the "Key Event" tab.
114
-
- Choose your keycode AND select your controller as the device in the dropdown menu.
115
-
- Save the keymap and hopefully it will work.
70
+
- Choose your key code AND select your controller as the device in the dropdown menu.
71
+
- Save the key map and hopefully it will work.
116
72
117
73
## "How can I 'jump bridge' with Key Mapper? / How can I use Key Mapper for Minecraft PVP?"
118
74
119
-
This is not an app designed for gaming. Please look elsewhere for help with this, such as YouTube tutorials or ask in [the discord server.](http://keymapper.club) Also note that use of 'jump bridging' or very fast attacks on Minecraft servers where it is not allowed has absolutely nothing to do with the developer and it is not endorsed or encouraged. Again, this is not an app optimised for playing mobile games.
120
-
121
-
## "Can I use the app on Chromebook?"
122
-
123
-
Not all features work on Chromebook. The app is not supported on Chromebook.
124
-
Key Mapper can't "tap the screen" for obvious reasons. If you want to play a game on Chromebook using Key Mapper with keyboard controls (especially *Among Us*) then you are unlikely to be able to do so.
75
+
This is not an app designed for gaming. Please look elsewhere for help with this, such as YouTube tutorials or ask in [the discord server.](http://keymapper.club) Also note that use of 'jump bridging' or very fast attacks on Minecraft servers where it is not allowed is not endorsed or encouraged. Again, this is not an app optimised for playing mobile games.
125
76
126
-
That being said, many features should work, such as remapping keyboard buttons.
127
-
128
-
## "Can I remap on-screen controls to buttons with Key Mapper?"
77
+
## "Can I remap buttons to on-screen controls with Key Mapper?"
129
78
130
79
Technically yes but it would be a horrendous gaming experience. There is an action in Key Mapper to touch the screen but Key Mapper is only allowed to tap/swipe in one place at a time. Therefore, you wouldn't be able to tap forward on an on-screen joystick and shoot at the same time for example. This is how the Android API works and there is nothing I can do to change it.
131
80
132
-
[Ask for help :fontawesome-brands-discord:](http://keymapper.club){: .md-button .md-button--primary }
133
-
134
81
## "Can I remap my Bixby button?"
135
82
136
83
Key Mapper doesn't yet offer a way to remap the Bixby button but if you are rooted you can remap the Bixby button to something that Key Mapper can remap. Follow this [guide](https://forum.xda-developers.com/t/remap-bixby-manually-using-all-in-one-gestures-bind-to-flashlight-root.3660378/) on XDA.
84
+
85
+
!!! discord "Want to ask for help?"
86
+
If you've already tried troubleshooting and the tutorials aren't enough, come and ask for help in our [support server.](http://keymapper.club)
[Key Mapper](https://github.com/keymapperorg/KeyMapper) is a free and open source Android app that can map single or multiple buttons to a custom action.
3
+
[Key Mapper](https://github.com/keymapperorg/KeyMapper) is the Android app that changes what the buttons on your devices do!
4
+
5
+
The app intercepts key events and allows you to design your own custom actions when a certain key combination is pressed.
6
+
7
+
You can create on-screen floating buttons that behave like physical keys, which you can also design actions for.
8
+
9
+
The core functionality of the app is proudly free and open-source software (FOSS). Certain special features are available as paid add-ons.
4
10
5
11
This wiki aims to provide users with a comprehensive guide to using and setting up Key Mapper for typical implementations. For specific help with more complicated key maps or if this wiki does not answer your questions, you can join the [Key Mapper Discord support server](http://keymapper.club) and ask for help.
16
+
The Key Mapper documentation aims to provide users with a comprehensive guide to using and setting up Key Mapper for typical implementations. If you need more help, you can join the [support server](http://keymapper.club) and ask for help.
11
17
12
-
[Get help :fontawesome-brands-discord:](http://keymapper.club){: .md-button .md-button--primary }
13
-
[Support the project :fontawesome-solid-heart:](https://ko-fi.com/sethschroeder){: .md-button }
14
-
[Share your key maps :material-hand-heart:](sharing.md){: .md-button .md-button--md-primary-bg-color }
18
+
--8<-- "preamble.md"
15
19
16
-
## Translations
20
+
!!! question "Want a tutorial?"
21
+
We've made some [handy tutorials](tutorials-index.md) to help you learn Key Mapper.
If you've already tried troubleshooting and the tutorials aren't enough, come and ask for help in our [support server.](http://keymapper.club)
25
25
26
-
## Star History
26
+
!!! love "Love the app?"
27
+
Please [rate us on Google Play.](http://app.keymapper.club)
28
+
If you would like to support the project, consider [donating](https://ko-fi.com/sethschroeder).
27
29
28
-
[](https://star-history.com/#keymapperorg/KeyMapper&Date)
30
+
--8<-- "tutorials-list.md"
29
31
30
32
## Our team 🧑💻
31
33
32
34
### Developers
33
35
34
-
-[Seth Schroeder (sds100)](https://github.com/sds100): Lead developer who started the project.
35
-
-[Tino W. (pixel-shock)](https://github.com/pixel-shock): Created the actions for swiping and pinching.
36
+
-[Seth Schroeder (sds100)](https://github.com/sds100): Lead developer who started the project
37
+
-[Tino W. (pixel-shock)](https://github.com/pixel-shock): Created the actions for swiping and pinching
-[Darío B. C.](https://github.com/bydariogamer) (Spanish)
47
+
48
+
## Star History
49
+
50
+
[](https://star-history.com/#keymapperorg/KeyMapper&Date)
0 commit comments