This utility allows you to dynamically remap keys or assign hotkeys on macOS. With it, you can create convenient key combinations and quickly switch functionalities to suit your needs.

Origin story:

This tool was inspired by the comfortable navigation in Vim, where moving around with h, j, k, l is quick and doesn't require reaching for arrow keys. I wanted to bring that same flexibility and speed to macOS — so navigation becomes fast and comfortable without relying on arrow keys or other awkward shortcuts.

Features

• Real-time key remapping
• Use of modifiers for flexible configuration
• Activation of rules when holding a specific "switch" key
• Easy setup via a configuration file

Requirements: macOS Big Sur 11.5 or later.

How to use

• Key remapping is activated when holding the [switch key], or via settings in the [general] section.
• Changes take effect immediately after launching.

Configuration
The configuration file consists of the following sections:

[general]
Rules that work without modifiers.

[switch key]
The modifier key that activates rules (e.g., a specific key code).

Remapping rules: source:target:modifiers

• source — source key code (required)
• target — target key code (required)
• modifiers — optional modifiers, separated by commas

Comments: lines starting with #.

Modifiers
You can use modifiers such as:
Caps Lock, Shift, Right Shift, Function, Control, Option, Right Option, Command, Right Command.
To find out specific key and modifier codes, use the built-in code detection feature in the app settings.

Configuration example

Installation instructions are in the README file of the repository:
https://github.com/bornthenord/hotpaws