# houmain/keymapper

A cross-platform context-aware key remapper.

Repository: https://github.com/houmain/keymapper
Canonical: https://ross.abutalabs.com/products/houmain-keymapper
Language: C++
License: GPL-3.0
License Family: copyleft
Topics: keyboard-shortcuts, keyboard-layout, context-awareness, keymapper, cross-platform, wayland, accessibility, automation, productivity
Last push: 2026-08-29T16:01:41+00:00

## Health v2 (maintenance only)
Score: 100/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 100, release rhythm 99, longevity 100
- inputs: {"age_days": 2719, "days_push": 4, "days_rel": 4, "gap_med": 14, "n_releases_24m": 32}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1140, forks 46 (observed 2026-09-01T02:14:02.907672+00:00)

## What it is
A cross-platform, context-aware key remapper that lets users redefine keyboard layouts and shortcuts systemwide or per application via a single hand-written configuration file. It runs as a daemon (keymapperd) on GNU/Linux, Windows, macOS, and FreeBSD, and includes keymapperctl for external control.

## Use cases
- remap caps lock to backspace systemwide
- change keyboard shortcuts per application
- manage all keyboard shortcuts in one config file
- share key remapping config between linux windows and mac
- swap key positions on a non-standard keyboard layout
- bind keyboard shortcuts to launch applications
- remap keys on wayland

## When to choose
- you need consistent key remapping across multiple operating systems
- you want per-application context-aware shortcut remapping
- you prefer a simple text-based configuration over GUI tools
- you use Wayland where many remappers don't work

## When to avoid
- you need a graphical interface to manage remapping
- you only need simple remapping already handled by your OS settings
- you need macro recording or complex scripted automation

## Facets
- artifact type: application
- maturity: active
- function: developer-tools, accessibility, workflow-automation, configuration-management
- domain: developer-tools, accessibility, cross-platform
- platform: windows, bsd, cross-platform, cli
- tags: key-remapping, keyboard-shortcuts, wayland, context-aware, keyboard-layout, system-utility, linux, macos

## Member repositories
- houmain/keymapper (main) score 100

## Provenance
- Observed fields: from GitHub, fetched 2026-09-01T02:14:02.907672+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-30T06:36:15.736189+00:00, confidence not recorded.
  - readme: https://github.com/houmain/keymapper (fetched 2026-09-01T02:14:02.907672+00:00, sha 999853d12444)
- Data as of 2026-08-30T08:39:29.467469+00:00.