Skip to content

Actions

Open app

Launch an app.

Launch app shortcut

Launch an app shortcut. This is a great way to add more functionality to Key Mapper.

Input key code

Attention

If you are on Android 11 or newer it is recommended that you install Shizuku. Read more about this here.

If you don't want to install Shizuku then you must be using the Key Mapper GUI Keyboard or the Key Mapper Basic Input Method for this to work. Follow this guide to set it up.

Input a simple key event with this key code.

Tap screen (2.1.0+, Android 7.0+)

This will tap a point on your screen.

!!! warning Android restricts what apps can do with this so you won't be able to tap the screen at the same time as Key Mapper and Key Mapper can't tap multiple places at once.

Swipe screen (2.5.0+, Android 7.0+)

This will swipe from a start point to and end point on your screen. You can also setup the amount of "fingers" to simulate and the duration for the gesture, but this is limitied due to your Android Version.

See: getMaxStrokeCount and getMaxStrokeDuration for more information.

Pinch screen (2.5.0+, Android 7.0+)

This will simulate a pinch gesture from a start point to and end point on your screen. You can choose between pinch in and pinch out and also the "pinch distance" for the pinch gesture. This is the distance between the start and the end point. The higher the distance, the stronger the pinch gesture, so you may want to start with a lower value for the pinch with max. 100. Later on you can adjust this by your needs, but the endpoints will never be less than 0 due to android restrictions.

You can also setup the amount of "fingers" to simulate and the duration for the gesture, but this is limitied due to your Android Version.

See: getMaxStrokeCount and getMaxStrokeDuration for more information.

Input key event (2.1.0+)

Attention

If you are on Android 11 or newer it is recommended that you install Shizuku. Read more about this here.

If you don't want to install Shizuku then you must be using the Key Mapper GUI Keyboard or the Key Mapper Basic Input Method for this to work. Follow this guide to set it up.

This will input a more complicated key event than the simple key code action.

Input text

Attention

You need to be using the Key Mapper GUI Keyboard or the Key Mapper Basic Input Method for this to work. Follow this guide to set it up.

This will input any text that you want.

Intent (2.3.0+)

This is a way to communicate with other apps, especially automation apps because they often have a way to trigger their own actions from an intent.

Read about intents in the Android SDK documentation here.

Example 1

Opening the WiFi settings on the device. These are the only fields that you need to fill in...

  • Description for Key Mapper = This can be anything you want because it is just for you to identify this action within the Key Mapper user interface.
  • Select "Activity".

  • Action = android.settings.WIFI_SETTINGS

Example 2

1. Setting up the Tasker event
  1. Select "Intent Received" event.
  2. You only need to fill in the "Action" field. The action can be anything you want but since the action must be unique on the device it is recommended to start it with net.dinglish.android.tasker. In Key Mapper you will have to use the exact same action.
2. Setting up Key Mapper

Send a broadcast to launch a Tasker action. These are the only fields that you need to fill in...

  • Description for Key Mapper = This can be anything you want because it is just for you to identify this action within the Key Mapper user interface.
  • Select "Broadcast receiver".

  • Action = The exact same action that you used in Tasker. In my example this would be net.dinglish.android.tasker.MY_ACTION.

Launching Termux command intents

You need to open the app info page for Key Mapper in your device settings and grant it the "run commands in termux environment" permission. On Android 12+ you must also turn off battery optimisation for Termux so that Android allows Termux to be started from the background.

Phone call (2.3.0+)

This will start calling the number that you put.

Play sound (2.4.0+)

This action will play a sound. Key Mapper will copy the sound file to its own folder, which means you won't have to worry about losing them. Key Mapper will only play one sound at a time and the sound will play forever until it stops or you pause your key maps. Your sounds will be backed up and restored with your key maps as well.

Toggle/enable/disable WiFi

Requires ROOT permission on Android 10+

If you aren't rooted then you must install the WyFy app. You must then use the Intent action in Key Mapper to send a broadcast that tells this app to change the WiFi state. In the WyFy's README it outlines the Intent parameters. This app works around the issue by targeting API 28 (Android 9), which means the app doesn't need to follow the new restrictions in API 29 (Android 10). But this means it can't be approved in the Play Store so you must install the apk manually from GitHub or through F-Droid.

Toggle/enable/disable Bluetooth

Toggle/enable/disable mobile data

Requires ROOT permission

Toggle/enable/disable auto brightness

Increase/decrease brightness

Toggle/enable/disable auto-rotate

Set screen to portrait/landscape

Set screen orientation to 0°, 90°, 180° or 270°

Cycle through screen orientations

Volume up/down

Mute/un-mute/toggle volume (Android 6.0+)

Show volume popup

Increase/decrease volume stream

This will increase or decrease a specific one of these volume streams.

  • Alarm
  • DTMF
  • Music
  • Notification
  • Ring
  • System
  • Voice call
  • Accessibility

Cycle through ringer modes

Change ringer mode

Cycle between vibrate and ring

Toggle/enable/disable do not disturb mode (Android 6.0+)

Expand/toggle notification drawer

Expand/toggle quick settings

Collapse the status bar

Play/pause/toggle media

Next track

Previous track

Fast forward

Rewind

Go back

Go home

Open recent apps

Toggle split screen (Android 7.0+)

Go to the last app (Android 7.0+)

Open menu

Toggle/enable/disable flashlight

Toggle/enable/disable NFC

Requires ROOT permission

Move cursor to the end of text

Toggle/show/hide on-screen keyboard (Android 7.0+)

Show keyboard picker (up to Android 9.0)

Requires ROOT permission on Android 8.1 and 9.0

Cut/copy/paste

Select word at cursor

Switch keyboard

Toggle/enable/disable airplane mode

Take screenshot

Requires ROOT permission on Android 8.1 and older

Open voice assistant

Open device assistant

Open camera app

Open settings app

Lock device

Requires ROOT permission on Android 8.1 and older

Secure lock device

This is different to 'lock device' because this will force you to unlock your device with your PIN or password and not with biometrics.

Turn on/off device

Requires ROOT permission

Show power menu

Answer/end phone call (2.4.0+)

If your phone is ringing then this action will answer the phone or if you are in a call then it will end it. Selecting this action will automatically add the constraint to your key map when your device is ringing or is in a call respectively.

Attention

If you are using a volume button trigger with these actions then this key map will only work if you are using on of the Key Mapper keyboards! This is because Android doesn't tell accessibility services when the volume buttons are being pressed when your device is ringing or is in a phone call. But it does tell input methods when they are being pressed so you must use a Key Mapper keyboard that tells Key Mapper when the buttons are being pressed.

Do nothing

Dismiss all notifications (2.4.0+)

Dismiss most recent notification (2.4.0+)