keyflow

Privacy-first keyboard remapper for Windows. Zero data collection, driver-level interception, JSON config.

Quick start

1. Install the Interception driver (one-time, requires admin) and reboot.
2. The bundled config.json ships the Eduuh-DH layout — see docs/EDUUH_DH.md for the full spec.
3. Run keyflow.exe. No admin needed once the driver is installed.

Press Ctrl+Escape to exit.

Example config

{
  "version": "1.0",
  "remapping": {
    "CapsLock": "LeftCtrl"
  },
  "layers": [
    {
      "name": "Vim Nav",
      "triggers": ["RightAlt"],
      "mappings": {
        "H": "LeftArrow",
        "J": "DownArrow",
        "K": "UpArrow",
        "L": "RightArrow"
      }
    }
  ]
}

See docs/CONFIG_USAGE.md for the full reference.

Build from source

.\build.ps1            # Release
.\build.ps1 -Tests     # Debug + tests

Requirements: CMake 3.15+, MSVC or any C++17 compiler. Details in BUILD.md.

CLI flags

Flag	Effect
--validate	Validate config and exit
-d, --debug	Verbose config-load logging
-v, --verbose	Write per-event log to keyflow_debug.log
[file.json]	Use a non-default config

Docs

• Config reference · Eduuh-DH layout · Custom modifiers · Privacy
• Contributing · Build · Changelog

Released under the MIT License. Bundles the Interception driver under LGPL-3.0 — see THIRD_PARTY_NOTICES.md.