omac

Mac-like nav for Omarchy.
⌘ shortcuts, Mac caret movement and Mac-feel workspace swipes, in one file you can read.

Install · Keys · Trackpad · How it works

Omarchy already gives you ⌘C, ⌘V and ⌘X. This adds the rest of what a Mac user's hands reach for without thinking: select all, undo and redo, new tab, the address bar, ⌘ and ⌥ arrows that move the caret, a ⌘W that closes the tab rather than the window, and a ⌘V that pastes screenshots into Claude Code. Then the trackpad scrolls the right way and workspaces swipe like they do on a Mac.

• ⌘ + letter. Twelve Mac shortcuts, each sent to the app as Ctrl + the same letter.
• Mac caret movement. ⌘ arrows to line and document ends, ⌥ arrows by word, ⇧ to select.
• Tab-aware ⌘W. Closes the tab, and the window once there is no tab left to close.
• Image paste in terminals. ⌘V sends Ctrl+V when the clipboard holds an image.
• Mac menu symbols. ⌘K lists every shortcut as ⇧⌘↩, not SUPER SHIFT + RETURN.
• Workspace swipes that feel like a Mac. A three-finger flick switches, a slow drag peeks and snaps back, and either way it slides home in 180 ms.
• Natural scrolling. Content follows your fingers.

Everything binds in one Lua file, hypr/omac.lua, so what a key does is one search away, and removing the file removes all of it.

Needs Omarchy 4 or newer, the release that configures Hyprland in Lua.

omarchy plugin add https://github.com/nchudleigh/omac --enable

The plugin runs install.sh from its folder every time the shell starts: the first run hooks the bindings into Hyprland, and later runs find everything in place and do nothing. If something stops it, such as an Omarchy without the Lua config, a desktop notification says why.

install.sh also works on its own from any checkout of this repo, and points Hyprland back at that checkout, so editing it and running hyprctl reload is the whole update.

Installed as a plugin, run the uninstaller first, or the plugin hooks omac back in on the next shell start:

~/.config/omarchy/plugins/io.github.nchudleigh.omac/uninstall.sh
omarchy plugin remove io.github.nchudleigh.omac

Run from a checkout of your own, use that checkout's uninstall.sh.

The uninstaller removes the three paths above and reloads Hyprland, which puts Omarchy's own bindings back.

Super is ⌘. On a Mac keyboard that is already the key beside Space; on a PC keyboard it is the Windows key, unless you move it.

Some of these keys held Omarchy window bindings, which move to Ctrl+Alt rather than disappearing:

⌥← and ⌥→ take Alt+arrow, which browsers use for back and forward, so ⌘[ and ⌘] do that instead, as on a Mac.

Screenshots use ⌥ where a Mac uses ⌘, because Super+Shift+number moves windows between workspaces. As on a Mac, a capture saves a file and shows a thumbnail you can click to mark up; it also lands on the clipboard.

The ⌘-letter keys do nothing in a terminal. Ctrl+Z suspends a job, Ctrl+D closes the shell and Ctrl+A moves to the start of the line, so sending them would be worse than doing nothing. ⌘← and ⌘→ still work there, as Home and End, and ⌥← and ⌥→ still move by word, because bash reads Ctrl+arrow as a word move. "Terminal" means Omarchy's own terminal window tag, the same one its clipboard bindings use.

⌘W closes the terminal window, because Ctrl+W there deletes a word. ⌘V pastes text with Shift+Insert, as Omarchy does, unless the clipboard holds an image: then it sends Ctrl+V, which is what Claude Code and other terminal apps read an image on. The clipboard check runs in its own process, bin/mac-paste, and gives up after half a second. It never runs inside Hyprland's config: wl-paste needs Hyprland to answer, so waiting on it from there freezes the whole desktop.

Hyprland cannot see an app's tabs, so ⌘W sends Ctrl+W and looks again 300 ms later. A closed tab changes the window title; a closed last tab, or an unsaved-changes dialog, moves focus. Same window, same title means nothing closed, and then it closes the window.

Browsers skip the second look. They close the window on the last tab themselves, and two tabs called "New Tab" would otherwise read as nothing closing. The same can happen in any other app with two identically titled tabs: ⌘W closes the window instead of one of them.

On a PC keyboard, extras/keyd/mac-modifiers.conf swaps Left Alt and the Windows key with keyd, so ⌘ lands where a Mac keeps it:

omarchy pkg add keyd
sudo cp extras/keyd/mac-modifiers.conf /etc/keyd/default.conf
sudo systemctl enable --now keyd

It is not part of the install, because it changes every keyboard on the machine and is wrong for an Apple one.

When you let go, the workspace slides the rest of the way with an ease-out cubic in 180 ms. Omarchy ships workspace animations off, so this also animates Super+1–9.

Two fingers can never be a gesture here. libinput reads two fingers as scrolling and only three or more as a swipe, so nothing in Hyprland ever sees a two-finger swipe.

Omarchy loads ~/.local/state/omarchy/toggles/hypr/ after your own ~/.config/hypr/bindings.lua, so the bindings here win where both claim a key, and every key they take over is released with hl.unbind first rather than left to fire twice.

The file in that directory is one dofile line rather than a symlink, because Omarchy lists the directory with find -type f, which skips symlinks.

• ⌘Tab app switching. Super+Tab stays Omarchy's workspace switcher. Moving workspace cycling to Super+Alt+Tab collides with Omarchy's next-window-in-group.
• ⌘F, ⌘S, ⌘P, ⌘O, ⌘G. Each holds an Omarchy window binding (full screen, scratchpad and so on) that people use daily. Copy the ⌘T pattern in the Lua file to take one.
• Caps Lock as Caps Lock. Omarchy makes it Compose, and the obvious fix, Compose on right ⌘, breaks anything bound to that key.
• Media keys first on the top row. That needs Apple's hid_apple driver and a root-owned file.

Thanks to Macifier by Alvaro Antolinez, where this started. Its ⌘-letter shortcuts, the rule that keeps them out of terminals, and the idea of a keybindings list in Mac terms shaped the first version here. If you want a dock, a ⌘Tab switcher and a bar panel to flip it all, Macifier has them.