omarchy4mac

Omarchy 4, for the Mac. An Omarchy port for macOS — for those of us who want the Omarchy experience but can't (or won't) leave the Mac.

Omarchy is DHH's opinionated Arch + Hyprland setup. This repo recreates the parts that matter on macOS with native tools:

The theme script is the centerpiece: theme --sync pulls every theme straight from the Omarchy repo and converts it for Ghostty, Neovim (LazyVim), and btop. theme random respects macOS light/dark appearance, and a launchd listener re-themes everything the instant the system flips appearance.

Install

One command. It installs Homebrew if needed, runs the Brewfile, links every config into place (anything already there is moved to *.bak-<date>), compiles the light/dark listener, loads the launchd agents, adds the shell file to ~/.zshrc, pulls the Omarchy themes, and starts the services:

curl -fsSL https://raw.githubusercontent.com/dividendsolo/omarchy4mac/main/install.sh | bash

Grant Accessibility to Hammerspoon and AeroSpace when macOS asks. Then ⌥K for the keybindings, ⌘⌥Space for the menu.

Update: run the same script again. It pulls, relinks, resyncs themes, and restarts the services. ~/code/omarchy4mac/install.sh --dry-run prints what it would do without touching anything.

Options: SKIP_APPS=1 skips Brave, Raycast, and FluidVoice. Not in the Brewfile, install what you use: Steam (gaming mode), Claude Code and Obsidian (the theme reaches them), Signal, 1Password, Typora, LocalSend, HandBrake. Each has a key; the key does nothing until the app exists. OMARCHY4MAC_DIR=/path changes the clone location. The screensaver needs cargo (rustup); without it the script skips ttfx and says so.

brew bundle --file=Brewfile          # or pick from it
git clone https://github.com/dividendsolo/omarchy4mac.git ~/code/omarchy4mac
D=~/code/omarchy4mac

ln -s "$D/aerospace/aerospace.toml" ~/.aerospace.toml
ln -s "$D/sketchybar" ~/.config/sketchybar
ln -s "$D/borders" ~/.config/borders
ln -s "$D/starship/starship.toml" ~/.config/starship.toml
mkdir -p ~/.hammerspoon && ln -s "$D/hammerspoon/init.lua" ~/.hammerspoon/init.lua
mkdir -p ~/.local/bin && for f in "$D"/bin/*; do [[ $f == *.swift ]] || ln -s "$f" ~/.local/bin/; done
mkdir -p ~/.config/omarchy/branding && cp "$D/omarchy/screensaver.txt" ~/.config/omarchy/branding/
echo "source $D/zsh/omarchy.zsh" >> ~/.zshrc

# Light/dark listener + AeroSpace crash watchdog (macOS 26 can kill AeroSpace)
swiftc -O -o ~/.local/bin/theme-appearance-listener "$D/bin/theme-appearance-listener.swift"
for p in "$D"/launchd/*.plist; do
  sed "s|/Users/YOU|$HOME|g" "$p" > ~/Library/LaunchAgents/"${p##*/}"
  launchctl load ~/Library/LaunchAgents/"${p##*/}"
done

# Screensaver (optional)
cargo install --git https://github.com/omacom/ttfx && ln -s ~/.cargo/bin/ttfx ~/.local/bin/ttfx

theme --sync && theme tokyo-night
brew services start sketchybar && brew services start borders && open -a Hammerspoon

Wallpapers

theme --sync downloads every theme's own backgrounds from the Omarchy repo into ~/Pictures/Wallpapers as <theme>_<file>. omarchy-cycle-wallpaper (⌘⌃P) cycles the ones for the current theme; unprefixed files you add act as a shared pool.

Keybindings

Press ⌥K for the searchable overlay. Highlights:

• ⌘⌥Space — Omarchy system menu (nested, searchable); ⌘Esc — System submenu
• ⌘⌃⇧Space — theme chooser
• ⌘⇧ + letter — web apps as app windows (HEY mail and calendar, Google Photos, YouTube, Grok; Google Chat on ⌘⇧⌃G)
• ⌘⇧⌃A — coding agent in a fresh terminal
• ⌘⌃P — cycle wallpaper
• ⌘⌃I — keep awake (caffeinate) with a bar indicator
• ⌘⌃G — gaming mode
• ⌘⌃⌥ T/W/B — time / weather / battery notice
• ⌥T — shuffle theme (random theme in the current light/dark mode)
• ⌥S — float / tile the focused window

Bonus features

A few pieces of this port go past parity. They exist because macOS made them easy, or because a Mac needed them.

• Auto re-theme on light/dark flip. Switch macOS appearance and the whole desktop switches to a random theme from the matching bucket: light system, light theme; dark system, dark theme. Terminal, editor, bar, btop, Claude Code, Obsidian, all at once. It is the optional listener above; set it up once and forget it. Omarchy has no equivalent, since Hyprland has no system appearance to follow.
• ⌥T shuffles within the bucket. Random theme, never the current one, never a dark theme on a light system.
• Theme reaches Claude Code and Obsidian. Omarchy stops at the terminal and editor. Here a switch recolors the Claude Code terminal theme and the Obsidian vault theme too.
• Crash watchdog. AeroSpace can self-terminate on macOS 26. The launchd agent above relaunches it on a crash and respects a clean quit.
• Gaming mode (⌘⌃G). Quits every Dock app, drops Tailscale if it is installed, and launches Steam. The reverse is a normal quit.

How close is this to real Omarchy?

71% of Omarchy v4.0.2 (Quattro), scored feature by feature below: ✅ we have it, or the Mac stand-in does the same job (1 point). ⚠️ partly there, with a plan (half). ❌ missing, nothing planned, whatever the reason (0). Items with no macOS meaning are left out. That is 23 matched, 4 partial, 8 not portable, out of 35 scored.

The short version: the keybinding vocabulary, the workspace model, the menu tree, the bar, the theme pipeline, the screensaver, and the shell are here. What is not here is Omarchy's Quickshell layer (panels, themed lock screen, OSD) and the Hyprland dispatchers AeroSpace lacks (groups, scratchpad, pin, opacity, gap toggle). Those have no macOS equivalent and are not coming. The item-by-item checklist is in docs/parity-v4.md; what changed and when is in CHANGELOG.md.

If a gap bothers you, open an issue.

Credits

• basecamp/omarchy — the original, and the live source of every theme this port uses.
• AeroSpace, SketchyBar, JankyBorders, Hammerspoon, Starship — the projects doing the actual work.

License

MIT