Uhk 80, Automatic keymap switching by process name tool here

My configuration
1

UHK Keymap Autochanger

Windows tray app that automatically switches Ultimate Hacking Keyboard (UHK) keymap + layer targets based on the active process.

Scope

  • OS: Windows

  • Device: UHK80 (right-half communication interface)

  • Method: direct UHK HID SwitchKeymap (0x11) + ExecMacroCommand (0x14) commands

Features

  • Process-based keymap + layer mapping (Code.exe -> DEV + fn, etc.)

  • Immediate fallback to defaultKeymap + base for unmapped apps

  • Duplicate-send prevention (no resend if target keymap/layer is unchanged)

  • Tray menu controls

  • Start with Windows support (HKCU Run)

  • JSON config persistence

Installation

Run the published EXE

Run UhkKeymapAutochanger.exe.

self-contained build does not require a separate .NET runtime install.

Enable auto-start

Open tray menu and turn on Start with Windows.

Usage

  1. Create keymaps (with abbreviations) and layer layouts first in UHK Agent.

  2. Run UhkKeymapAutochanger.exe.

  3. Right-click tray icon, then open Open Settings.

  4. Save your default keymap and process rules (keymap + layer).

Tray menu:

  • Open Settings

  • Start/Stop Switching

  • Start with Windows

  • Exit

Config File

  • Path: %AppData%\UhkKeymapAutochanger\config.json

  • Auto-created on first launch

Schema:

{
  "defaultKeymap": "DEF",
  "pollIntervalMs": 250,
  "startWithWindows": true,
  "pauseWhenUhkAgentRunning": true,
  "rules": [
    { "processName": "Code.exe", "keymap": "DEV", "layer": "fn" },
    { "processName": "chrome.exe", "keymap": "WEB", "layer": "base" }
  ]
}

Field meanings:

  • defaultKeymap: fallback keymap abbreviation

  • pollIntervalMs: active-window polling interval (100~1000)

  • startWithWindows: auto-start with Windows

  • pauseWhenUhkAgentRunning: if true, pauses switching while UHK Agent is running

  • rules: process-to-target mappings (keymap + layer)

Rule fields:

  • processName: executable name (for example Code.exe)

  • keymap: keymap abbreviation (ASCII)

  • layer: one of base, fn, mod, mouse, fn2, fn3, fn4, fn5, alt, shift, super, ctrl

Compatibility:

  • Existing configs with rules[].keymap only are still supported.

  • If rules[].layer is missing or empty, it is normalized to base.

If the config is invalid, the app creates a backup *.invalid.json and regenerates defaults.

UHK Agent Behavior

  • Default is pauseWhenUhkAgentRunning=true.

  • This reduces HID conflicts while UHK Agent is active.

  • If you disable it, switching can work with Agent running, but conflict risk is higher.

4 Likes
2

Wow, thanks!
So far, so good. Seems to work incredibly smooth for me. There’s really not much to say TBH; it just works!

Any chance to add layer switching in the future?

3

Here it is, but since the layer is a toggle, it will remain as base after another layer is activated.

1 Like
4

:eyes:
Well, that was fast! Works as expected, thanks again!