omarchy-mac-keybinding

What it is

If your hands were trained on a Mac, every Linux desktop starts with a week of hitting the wrong modifier. omarchy-mac-keybinding ends that on Omarchy: ⌘A selects all, ⌘Z undoes, and ⌘K opens Omarchy's keybindings menu with everything labelled in Mac terms - Command, Option, Control - the way your fingers already think.

The trick is restraint: it never remaps the physical keyboard. Linux's internal modifier structure stays exactly as Omarchy shipped it - only the labels, shortcuts and menu presentation change. And the trackpad comes along: natural two-finger scrolling, tap-to-click, two-finger right-click, horizontal swipes to switch workspaces, vertical gestures for apps and scratchpads.

It's also built to survive: the keybindings wrapper regenerates its cached copy whenever Omarchy updates, and the installer backs up whatever it touches - system files are preserved, so an Omarchy upgrade never eats your setup. Together with touch-bar, it's the full MacBook-on-Linux kit.

Highlights

• ⌘ editing shortcuts - Select All, Undo and friends where your fingers expect them
• ⌘K opens the Omarchy keybindings menu with Mac modifier labels (Command, Option, Control)
• No physical remapping - Linux's internal modifier structure stays untouched
• Trackpad gestures: natural scrolling, tap-to-click, two-finger right-click
• Horizontal swipes switch workspaces; vertical gestures open apps and scratchpads
• Update-safe: the wrapper regenerates its cache whenever Omarchy updates
• Installer backs up existing files and manages its own config blocks

Install

git clone https://github.com/niraj-envision/omarchy-mac-keybinding.git
cd omarchy-mac-keybinding
./install.sh

Then hit ⌘K (or the Learn menu). Requires Omarchy with the Lua-based Hyprland config (Hyprland 0.55+); tested on a 2018 Intel MacBook Pro on Hyprland 0.56.2.