Use this command to install KeyMaster-Pro with WinGet:
winget install --id=KeyMasterPro.KeyMasterPro -e
KeyMaster Pro is a powerful keyboard shortcut manager for Windows built with Tauri v2, React 19, and Rust. Designed to streamline your workflow, it enables you to create, manage, and execute complex keyboard and mouse shortcuts with precision.
Key Features:
Global Hotkey Registration: Assign custom shortcuts to trigger actions across any application.
Named Pipe IPC Communication: Efficient inter-process communication for seamless functionality between the GUI and background daemon.
System Tray Integration: Keep KeyMaster Pro running in the system tray for easy access and out-of-sight operation.
Auto-updates via Tauri Updater: Receive updates directly within the application or via winget.
Sleek Modern Interface: Features a dark mode-supporting design with intuitive navigation.
Audience & Benefit:
Ideal for power users, developers, and anyone seeking to optimize their productivity on Windows. KeyMaster Pro allows you to create sophisticated shortcuts that enhance efficiency, reduce repetitive tasks, and customize your computing experience to suit your workflow perfectly.
README
⌨️ KeyMaster Pro
Keyboard and mouse remapping, macros, layers, text expansion and AI-assisted automation for Windows
KeyMaster Pro is a Windows desktop input-automation utility built around one rule model:
TRIGGER + CONDITIONS -> ACTIONS
The application uses a Rust daemon for low-level Windows hooks, input-state machines, context tracking, macro execution and profile writes. The desktop GUI is built with Tauri + React/TypeScript. GUI and daemon communicate through Named Pipes / JSON-RPC.
> Documentation rule: this README describes the current stable release. Shipped history belongs in CHANGELOG.md; remaining work belongs in ROADMAP.md.
Current capabilities (v0.5.1)
Keyboard and mouse
Key Down / Key Up triggers with Ctrl, Alt, Shift, Win modifier combinations.
Combination-to-combination key remapping.
Expanded Windows VK catalogue and chord-aware key picker.
guarded unsaved drafts during navigation, exit, restart and update;
single-instance GUI and hardened daemon lifecycle/IPC.
Automation Lab
v0.5.0 introduced the first production Automation Lab slice. v0.5.1 hardens its real Windows UX.
AI Automation Composer
KeyMaster can generate a draft of rules/macros through an OpenAI-compatible provider and requires explicit installation before anything is written to the active profile.
Provider profiles are configured once in Settings → AI providers.
Each profile stores a name, endpoint and model in KeyMaster settings.
The API key is stored separately in Windows Credential Manager, not in plaintext profile/config JSON.
Editing a provider with an empty key field keeps the already stored key.
Composer uses the selected saved provider; the key does not need to be pasted for every request or after every restart.
Plain http:// is accepted only for localhost providers; remote providers must use TLS (https://).
Provider/network failures cross the Rust boundary as stable error codes and are localized in EN/RU.
Generated output is visibly marked as a draft / not installed.
Prompt and generated draft survive navigation away from Automation Lab and back during the app session.
Rules/macros are re-deserialized and validated by the Rust daemon before any profile write.
Installation creates a backup and an Undo receipt.
After successful AI installation KeyMaster reloads the profile and opens Rules so the installed rules are immediately visible.
A typical Groq-compatible profile can use:
Name: Groq
Endpoint: https://api.groq.com/openai/v1
Model:
API key: saved once in Windows Credential Manager
MCP bridge
KeyMaster exposes a local stdio MCP server through the installed executable:
KeyMaster-Pro.exe --mcp — read-only profile/status reads plus rule validation.
KeyMaster-Pro.exe --mcp-write — explicit opt-in for profile activation, macro execution and rule writes.
Use --mcp-write only when write/execute access is deliberately required.
The current local bridge exposes seven tools across profile listing/reading, runtime status, rule validation, profile activation, macro execution and rule installation. Writes use the same canonical Rust automation boundary as the GUI.
ChatGPT scope: the shipped bridge is local stdio. Remote MCP hosting/authentication for ChatGPT is a separate future task.
keymaster-pack v1
Portable Automation Lab bundles use:
{
"format": "keymaster-pack",
"version": 1
}
Safety rules:
import limit: 2 MiB, checked before and after file read/parsing;
local inspection reports permissions and high-risk actions before install;
imported macro/layer/folder/rule UUIDs are regenerated and internal references are rebound;
duplicate IDs, dangling references, folder cycles, empty actions and malformed payloads are rejected;
final acceptance uses the same Rust validation/write boundary as AI and MCP;
installation is backup-first and Undo-capable.
Validation
The Windows CI used for v0.5.1 runs:
Vitest frontend tests
TypeScript + Vite build
cargo check --all-targets --locked
cargo test --locked
ESLint
real-process MCP stdio smoke
The MCP smoke builds a real KeyMaster executable, launches an isolated daemon, connects with the official MCP client and exercises both read-only/write modes, all seven tools, persistence, backup/Undo protection and concurrent profile mutations.
Important current limitations
The following are intentionally not claimed as complete in v0.5.1:
reliable secure/password-field detection for Text Expansion across arbitrary applications and browsers;
a dedicated public portable ZIP release asset;
a full user-facing backup browser/restore center beyond current backup + Automation Lab Undo safeguards;
a separate explicit layer-priority model beyond rule priority/order;
general scripting/plugin APIs and browser automation;
cloud sync/account infrastructure;
remote MCP hosting for ChatGPT;
the second Automation Hub layer such as diff/conflict analysis, signed catalog/marketplace and discovery.
one daemon owns the Named Pipe/input engines at a time;
unsupported conditions must not silently fail open;
low-level hooks stay free of slow file/network work;
advanced input state machines stay bounded;
macro delays do not block immediate remaps;
profile mutations are serialized and validated before write;
migrations remain backward compatible and non-destructive.
Download
Installer (recommended)
Open GitHub Releases and download the Windows installer for the latest release.
The installed application can update itself through the built-in signed updater.
MSI
An x64 MSI can also be produced by the release workflow.
WinGet
winget install KeyMasterPro.KeyMasterPro
Portable build
A deliberate public portable ZIP remains planned. Dev/checkpoint standalone binaries are not treated as the stable portable distribution.
Build from source
Prerequisites
Windows 10/11 x64;
Node.js 22 recommended;
pnpm 9+;
current stable Rust toolchain (MSVC target);
Visual Studio Build Tools with C++ build tools.
Commands
git clone https://github.com/zsanya322-maker/keymaster-pro.git
cd keymaster-pro
pnpm install
pnpm tauri dev
Production build:
pnpm tauri build
Windows bundles are generated under:
src-tauri/target/release/bundle/
Privacy and input handling
KeyMaster Pro needs low-level keyboard and mouse hooks to remap input. Those APIs can also be used by keyloggers, so security software may treat this class of utility cautiously.
The project processes input events in memory for matching/remapping and does not intentionally persist a keystroke history. Text Expansion keeps only a bounded in-memory buffer. Profiles/settings remain local. AI provider API keys are stored separately through Windows Credential Manager. The built-in updater contacts GitHub Releases when checking/downloading updates.
Development history / roadmap
Completed major sequence:
0.3.0 — modifier/key combinations, expanded key model and nested rule-tree foundation;
0.3.1 — mouse trigger completion and macro playback/control;
0.3.2 — profiles, auto-switch/manual lock and richer context matching;
0.3.3 — Text Expansion templates, delimiter modes and undo;
0.4.0 — Leader Keys, Sequences, ordinary-key Chords and Mouse Gestures;
When a feature changes rules or profiles, treat schema + migration + compiler/runtime + UI + tests as one unit. A UI control alone does not make a feature complete.
License
KeyMaster Pro is licensed under the Fair Core License (FCL). See LICENSE for the exact terms and conversion date.
