# keymapperorg/KeyMapper

An Android app to remap the buttons on your devices

Repository: https://github.com/keymapperorg/KeyMapper
Canonical: https://ross.abutalabs.com/products/keymapper
Homepage: https://keymapper.app
Language: Kotlin
License: GPL-3.0
License Family: copyleft
Topics: keyboard, keymapping, keymapper, android, android-app, androidapplication, keyevent, android-development, kotlin, android-accessibility, accessibilityservice, bluetooth, bluetoothkeyboard, keyboard-shortcuts, keyboards, xda-thread, switch, nintendo-switch, joycon
Last push: 2026-08-11T23:56:14+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 97, release rhythm 97, longevity 100
- inputs: {"age_days": 2970, "days_push": 22, "days_rel": 22, "gap_med": 7, "n_releases_24m": 38}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2615, forks 257 (observed 2026-08-28T04:07:04.581624+00:00)

## What it is
Key Mapper is a free and open-source Android app that remaps buttons on phones, keyboards, gamepads, headsets, and other devices using an accessibility service. It lets users build macros with over 100 actions, custom triggers, constraints, and on-screen floating buttons.

## Use cases
- remap volume buttons to toggle the flashlight
- make a gamepad button tap the screen
- create custom macros on a bluetooth keyboard
- make the power button call someone when pressed five times
- create on-screen floating buttons that act like keys
- remap headset buttons to control media playback

## When to choose
- you want to remap physical buttons or keys on an Android device without root
- you need macros combining taps, gestures, keyboard input, or app launches
- you want a FOSS key remapper available on Google Play and F-Droid

## When to avoid
- you need to remap mouse buttons or joystick/trigger axes, which are unsupported
- you need button remapping on non-Android platforms
- your device aggressively kills background apps and you cannot disable battery optimization

## Facets
- artifact type: application
- maturity: active
- function: workflow-automation, developer-tools
- domain: android-tools, developer-tools, accessibility, gaming-tools
- platform: -
- tags: key-remapping, macros, accessibility-service, gamepad, bluetooth-keyboard, floating-buttons, foss, android, mobile

## Member repositories
- keymapperorg/KeyMapper (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:04.581624+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:20:25.762670+00:00, confidence not recorded.
  - readme: https://github.com/keymapperorg/KeyMapper (fetched 2026-08-28T04:07:04.581624+00:00, sha bd84c7d1e624)
  - homepage: https://keymapper.app (fetched 2026-08-29T10:03:24.336671+00:00, sha bbe27464fed4)
  - site_page: https://keymapper.app/user-guide/oculus (fetched 2026-08-29T10:03:24.348514+00:00, sha 760eccc21a37)
  - site_page: https://keymapper.app/faq (fetched 2026-08-29T10:03:24.346093+00:00, sha 026b21a34036)
- Data as of 2026-08-30T08:39:29.467469+00:00.