Skip to content

Fingerprint Gesture Maps (2.2.0+, Android 8.0+)

This page aims to explain how to remap fingerprint gestures. For specific troubleshooting, consult the FAQ.


This feature of Key Mapper does not support all devices. If you are having trouble with remapping fingerprint gestures, make sure you have read and understood the disclaimer below.


This guide is updated to match current stable release UI. Report inaccuracies.


On some devices, the fingerprint sensor can be remapped by Key Mapper. There are generally 3 categories of devices with varying degrees of support for this feature:

  1. Some devices have a fingerprint sensor that can detect directional gestures (up, down, left, right swipes) and your device allows third party apps such as Key Mapper to access and remap these.
  2. Some devices have a fingerprint sensor that can detect directional gestures (up, down, left, right swipes) but your device does not allow Key Mapper to access them.
  3. Some devices have a fingerprint sensor that is not capable of detecting directional gestures. This generally includes in-screen fingerprint sensors.

If your device falls into categories 2 or 3, you cannot remap fingerprint gestures, and you shouldn't continue with this guide. Even if your device allows for directional fingerprint gestures for system use, they may not allow third party apps such as Key Mapper to access them and therefore there is nothing the developer of Key Mapper can do to help you.

If your device supports remapping directional fingerprint gestures, this guide is for you.

Remapping fingerprint gestures

From the Key Mapper home screen, tab the 'Fingerprint' tab.

Here you can set actions for the 4 directional gestures. Tapping any one of them will bring you to the action assignment screen for that gesture and by tapping 'Add action' at the bottom of the screen you can assign the action. Click here for an explanation of all the actions you can choose from.

After choosing an action (or actions) you can press the save :fontawesome-solid-save: icon in the bottom right to save the mapping.

Make sure to save :fontawesome-solid-save: your fingerprint gesture map after applying these changes.

Customising actions

If you would like to customise how the actions are performed you can tap the 3 dot menu to the right of an action.

On this screen you can choose from the following options:

  Hold down until swiped again

This option allows for keycode actions to be 'held', much like you could hold down a physical keyboard key. The action will continue until the same gesture is performed a second time.

 Delay before next action (ms)

Key Mapper 2.2.0+

This option takes effect if you have multiple actions in your mapping. The slider sets the amount of time between this action and the next.

 How many times

Key Mapper 2.1.0+

On Key Mapper 2.2.0 and 2.1.0 this is called "action count".

This option serves as a multiplier. If this is equal to 5 when your mapping is triggered then your action will be performed 5 times. If this is used with the 'repeat' option then this will perform the action this many times every time it repeats.

  Repeat until swiped again

When this is turned on, Key Mapper will execute your actions repeatedly. This is particularly useful when emulating a keyboard key press, where in most applications holding down the key would result in a repeating output.

 Repeat every... (ms)

This option sets the time period for your repeating action. If this is set to 200, your action will repeat every 200ms, or in terms of frequency, 5 times per second. Some people prefer to think about this setting as a repeat rate, commonly measured in 'clicks' per second or cps. To calculate the appropriate time period for this option from a desired frequency, use this equation:

Time period (ms) = 1000 / Frequency ('cps')

 Repeat limit

Key Mapper 2.3.0+

Changing this will change how many times the action will repeat. By default this is set to "no limit".

 Stop repeating when...
    Swiped again                        Limit reached           

  • Swiped again. Swiping the fingerprint reader once will be sufficient to start your repeating key map. To stop the key map, you will need to swipe a second time.

  • Limit reached. (Key Mapper 2.3.0+). Your key map will stop repeating once the limit has been reached.

Tap 'Save' to close the menu, preserving changes.

Special options

For extra customisation, tap the 'Constraints and more' tab at the top of the screen when editing or creating a gesture map. On this screen you can choose from the following options:


 Vibrate duration (ms)

Tapping 'Vibrate' will cause your device to vibrate whenever you trigger your mapping. You can change how long your device vibrates with the slider.

  Show an on-screen message

When this is turned on, the following notice will come up at the bottom of the screen when ever you trigger your mapping.

Adding constraints

Constraints allow you to restrict your mappings to only work in some situations.

To add a constraint fron the 'Constraints and more' or 'Options' tab, tap 'Add constraint'.

Go here to see how you can configure constraints.