Help

Why doesn't the app open in DEX mode?

Samsung Dex doesn't allow apps with a 3rd party keyboard to open while in Dex mode. You can still configure key maps while out of Dex mode and your key maps which don't require the Key Mapper keyboard will still work in Dex mode.

Why don't my volume buttons work when I press them?

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.

Why aren't my mappings working?

If you have made sure they are enabled and they have atleast one trigger, restart the accessibility service by turning it off and on again (help below). If that doesn't work, report an issue (help below) to the developer describing your configuration (e.g the chosen action, trigger, Android version and your device/ROM).

Why doesn't the app uninstall?

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 widely on devices but on skins close to stock-Android it is under "Security" -> "Device admin apps".

How do I enable the accessibility service?

Open the Key Mapper app and click “Fix”, where it says, “the accessibility service must be enabled”. If that doesn’t work…

1. Open your device Settings app.
2. Find and open the “Accessibility” section. On some devices it might not be on the main screen and is sometimes under “System”.
3. Click the Key Mapper listing.
4. Press the switch to enable the Key Mapper accessibility service.

If there isn't an Accessibility settings page on your device, follow the instructions below to give the app permission to write to secure settings.

How do I give the app WRITE_SECURE_SETTINGS permission?

If your device is rooted, Key Mapper can grant itself the permission by enabling the "Key Mapper has root permissions" toggle in the settings.

If your device isn't rooted...

1. Download the Android SDK platform tools from here and unzip it.
2. Open a terminal/command-prompt in the folder you downloaded.
3. Type "adb shell pm grant io.github.sds100.keymapper android.permission.WRITE_SECURE_SETTINGS"
4. You can now enable the accessibility service and choose the Key Mapper keyboard without going into the Android settings. This permission persists across reboots and needs to be granted everytime you install the app. More features which rely on this permission will come in the future. 😀

Why can't I use the on screen keyboard with the Key Mapper keyboard?

Some users have wondered why they can't use the on-screen keyboard while using the Key Mapper keyboard and this is why... I originally made the app so I could map the keys on my Bluetooth keyboard to the correct characters since it was made for an iPad. A limitation of Android is an app can only input characters and keys if it is the SELECTED input method, which is why the Key Mapper keyboard needs to be chosen to use the Keycode, Key and Text actions. I didn't design it to have an on-screen keyboard since I would be using the physical keyboard anyway. But after multiple requests and suggestions I have decided to implement the AOSP keyboard into the Key Mapper keyboard at some point. This is also why there are a few settings controlling when to show the keyboard, since I wanted to make switching between the on-screen keyboard and the Key Mapper keyboard seamless.

Why aren’t the “Keycode”, “Key” and “Text” actions working?

The Key Mapper keyboard must be enabled in your device settings and chosen as the active keyboard.

To enable the keyboard:

Open the Key Mapper app and click "Fix" where it says, "the keyboard must be enabled". If that doesn't work…

1. Open your device Settings app.
2. Find and open the “Languages and Input” section. On some devices it might not be on the main screen and is sometimes under “System”.
3. Click on “Key Mapper Keyboard” to enable the keyboard. The toggle may be hidden under sub-menus on some devices.

To choose Key Mapper as the active keyboard: ⌨️

1. Click on the “Choose keyboard” (“Choose input method” on older devices) notification. Or you can click the Key Mapper “Click to choose keyboard” notification if you have enabled it in the Key Mapper settings.
2. Click “Key Mapper Input Method”.

How do I go back to my default keyboard?

Change the active keyboard as described above.

Why isn’t the Key Mapper “choose keyboard” notification working?

For Android 8.1 and newer root is required since Google has blocked the ability for apps to open the input method picker outside of the app. If your device isn’t rooted, Use the Android system's “Change keyboard” notification instead.

How can I report an issue?

Open the About activity and click “Rate and Review” to leave a review on the Google Play store or go to the XDA thread, Telegram Channel linked in the README and About activity. Or send an email to [email protected]. 😀