The macOS experience for Omarchy on Apple Silicon — a suite of small daemons and tools that make a MacBook running Omarchy/Asahi feel like the machine it was built to be.
Renamed from
omarchy-mac. That name already belongs to a separate project, an Arch/Hyprland distro for Apple Silicon, and the collision confused people. The commands it installs aremacarchy-*for the same reason.
Companion pieces live in their own repos: the macarchy-touchbar Touch Bar daemon, the omarchy-aquarium animated background and the apple-glass / apple-glass-light themes.
| Tool | What it does |
|---|---|
macarchy-als |
Ambient-light auto brightness for panel and keyboard backlight; learns your preferred offset from manual brightness key presses. |
macarchy-battery-limit |
Toggle the battery charge ceiling between 80% (kind to the cells) and 100% (travel mode). Needs the udev rule below for rootless operation. |
udev/90-battery-charge-limit.rules caps charging at 80% at boot and lets
the wheel group flip the thresholds without root.
libinput/60-apple-mtp-touchpad.quirks holds touch-size thresholds measured
on the MTP trackpad with libinput measure touch-size (finger "down" size,
thumb and palm rejection). Upstream libinput ships USB Magic Trackpad numbers
for this device, which drop light fingers from the count at gesture start.
Installed as /etc/libinput/local-overrides.quirks; applies at next login.
| Tool | What it does |
|---|---|
macarchy-dock |
macOS-style autohiding dock (nwg-dock) with a hotspot reveal. |
macarchy-dock-theme |
Regenerates the dock stylesheet from the current Omarchy theme; installed as a theme-set hook so the dock follows theme changes. |
macarchy-pinch |
Four-finger pinch gestures from libinput (Hyprland only handles swipes). |
macarchy-zoom |
macOS-style screen magnifier on Hyprland's cursor zoom (Ctrl + scroll). |
macarchy-auto-appearance |
Switches between the Apple Glass and Apple Glass Light themes at sunrise and sunset (or on a fixed schedule), like macOS's "Auto" appearance. Driven by a systemd user timer; "Auto" is on exactly when that timer is enabled, and the Control Center's Affichage page flips it. An existing conf without MODE now follows the sun; add MODE=schedule to keep a fixed LIGHT_FROM/LIGHT_UNTIL window. |
macarchy-sun |
Prints today's sunrise and sunset for the shared location (~/.config/omarchy/dynamic-wallpaper.json). |
macarchy-bar-contrast |
Picks the transparent bar's text colour from a live capture of the bar strip (Omarchy's own picker samples the wallpaper file and cannot see the aquarium above it), and writes it to ~/.config/omarchy/shell.toml. Systemd timer, a theme-set hook, and an omarchy-aquarium hook — toggling the tank repaints the very screen it samples. |
macarchy-locate |
Detects the machine's location (ip-api.com) and stores it in the shared location file, for the aquarium, the dynamic wallpaper and the auto appearance alike. |
macarchy-gtk-settings |
Keeps GTK's settings.ini in step with the current Omarchy theme for apps that ignore gsettings. |
macarchy-keys.lua extends Omarchy's universal copy/paste to the whole Cmd
vocabulary — select all, undo/redo, save, find, tabs, windows, zoom — with
terminal-aware chords (Cmd+S never freezes your shell, Cmd+Z never suspends
your job). Colliding window-manager binds move to their genuine macOS homes:
fullscreen on Cmd+Ctrl+F, hide-to-scratchpad on Cmd+H.
macarchy.switcher is an Omarchy shell plugin: hold Cmd, tap Tab, release
to switch. One icon per app, recency-ordered, a sliding selection pill, real
theme glass, and the quick-tap detail: a fast Cmd+Tab flips to the previous
app without ever flashing UI. Escape or a click outside cancels; clicking an
icon switches to it. The glass needs the theme to blur the
macarchy-switcher layer namespace (the apple-glass themes do).
./install.sh # scripts, hook, timer, example configs
./install.sh --udev # also the battery udev rule + libinput trackpad quirks (sudo)
Then wire the daemons and keybindings into Hyprland — see
hypr/example.lua.
MIT.