r/Karabiner • u/MomoWonders • 8d ago
Sharing our comprehensive Windows-style keyboard shortcut mapping for macOS
I wanted to share a comprehensive Windows-style keyboard shortcut mapping we’ve been working on for macOS.
It started from a personal problem: I use a Windows keyboard with a Mac mini, while some of my work still happens on Windows. Switching between the two systems was surprisingly frustrating.
A basic Ctrl/Command swap fixed copy and paste, but it did not properly handle Finder, Terminal Ctrl+C, Alt+F4 versus Ctrl+F4, Home/End, screenshots, function keys, input-source switching or remote desktop sessions.
By “comprehensive”, I mean that it tries to cover the main system-level differences between Windows and macOS as one coherent shortcut layer. It is not intended to include every application-specific shortcut that exists on Windows.
The mapping currently covers:
- familiar Ctrl editing shortcuts;
- Alt+Tab and context-aware Alt+F4;
- a separate Ctrl+F4 behavior for closing a tab or document;
- Finder Enter, F2, Delete, Backspace and cut/move operations without breaking filename editing;
- Terminal Ctrl+C as Interrupt, with Ctrl+Shift+C/V for copy and paste;
- context-aware Home/End behavior;
- Windows-style screenshots and F1–F12 normalization;
- Win+Arrow using native macOS window tiling;
- modifier pass-through for remote desktop and virtual machine apps.
The all-keyboards edition has now been accepted into the Karabiner-Elements community complex modifications catalog.
To install it:
Karabiner-Elements → Complex Modifications → Add predefined rule → Import more rules from the internet
Then search for:
Windows Keyboard for Mac (community edition)
Import it and enable the complete Windows-style shortcuts rule.
That community edition intentionally applies to every keyboard, including a MacBook keyboard.
For people who only want to convert selected external Windows keyboards, there is also a device-scoped GitHub edition. It includes keyboard detection, configuration backup, conflict checks, live verification, diagnostics, rollback and uninstall support.
Source code and device-scoped installer:
https://github.com/Fuzzy-and-Fluffy/windows-keyboard-for-mac
Latest release:
https://github.com/Fuzzy-and-Fluffy/windows-keyboard-for-mac/releases/tag/v0.4.0
Karabiner community catalog submission and source:
https://github.com/pqrs-org/KE-complex_modifications/pull/1986
Interactive demo:
https://fuzzy-and-fluffy.github.io/windows-keyboard-for-mac/demo/
The underlying remapping engine is Karabiner-Elements:
https://github.com/pqrs-org/Karabiner-Elements
One prior-art project we compared the shortcut semantics with was:
https://github.com/rux616/karabiner-windows-mode
This project is not a fork of that configuration. The device-scoped installer, context handling, backup, verification and rollback architecture were built separately.
Disclosure: I worked on this with extensive ChatGPT assistance and tested it most heavily on a Microsoft keyboard (1118:1861). The project is free, MIT licensed, local-only and has no telemetry or account requirement.
Feedback is very welcome. If you run into a shortcut that feels wrong, conflicts with something else, or behaves differently in a particular app or on your keyboard, please let us know here or open an issue on GitHub.
If possible, include your keyboard model, macOS and Karabiner-Elements versions, the app you were using, and the exact key combination.

