How to Build and Install a Custom Keyboard with Microsoft Keyboard Layout Creator

Beginner’s Guide to Microsoft Keyboard Layout Creator: Step-by-Step

What it is

Microsoft Keyboard Layout Creator (MSKLC) is a free Windows utility that lets you create or modify keyboard layouts, assign characters to keys, and build an installer so others can install your layout.

Who it’s for

• New users who want custom key mappings (special characters, diacritics).
• Multilingual typists needing easy access to nonstandard characters.
• Developers/localizers creating locale-specific layouts.

Before you start

• Requirements: Windows ⁄₁₁ (MSKLC runs as a legacy app; test compatibility).
• Download: Get MSKLC from Microsoft’s official download page.
• Backup: Note your current layout settings or create a system restore point.

Step-by-step workflow

1. Open MSKLC — Launch the app; choose “New” to start a blank layout or “Load Existing Keyboard” to modify an installed layout.
2. Select base layout — Pick a layout (e.g., US) to inherit usual key positions.
3. Assign characters — Click a key to edit its assignments for unshifted, Shift, AltGr (Right Alt) and Shift+AltGr states. Use Unicode input for special symbols.
4. Define dead keys — Create dead keys that combine with following keystrokes to produce accented characters (click “Dead key” and map combinations).
5. Test the layout — Use the built-in typing test window to confirm characters and dead-key combinations behave as expected.
6. Set metadata — Fill in layout name, description, language, and locale identifier in the Project Properties.
7. Build installer — From the Project menu, choose “Build DLL and Setup Package.” MSKLC generates an installer (.msi) and files required for installation.
8. Install and enable — Run the generated installer, then add the layout via Windows Settings → Time & language → Language → Keyboard.
9. Share or deploy — Distribute the .msi to others or include it in deployment scripts.

Tips and best practices

• Use Unicode codes (U+####) when assigning rarely used characters.
• Keep modifiers consistent — Reserve AltGr for extended characters to avoid conflicts.
• Name clearly — Use a descriptive layout name so users can identify it in Windows.
• Test on target systems — Particularly on different Windows versions or language packs.
• Use source control for .klc project files if you iterate frequently.

Common issues and fixes

• Installer won’t run: enable compatibility mode or run as admin.
• Characters not appearing: verify correct Unicode code points and input states (Shift/AltGr).
• Dead keys producing wrong output: re-check dead-key mapping order and test each combination.

Alternatives

• For cross-platform needs, consider AutoHotkey (Windows) or custom XKB layouts (Linux).
• For GUI-based remapping without installers, PowerToys Keyboard Manager (Windows) is simpler but limited.

Quick checklist before publishing

• Build and test installer on a clean VM.
• Verify language/locale metadata.
• Document special key combinations for users.

If you want, I can generate the exact keystroke mapping file (.klc) for a specific custom layout—tell me which characters you need accessible.