Repository navigation
Releases: omacom/omarchy-mac
Release list
Omarchy Mac 4.0.3rc4
Omarchy Mac 4.0.3rc4
Frozen candidate tip: 79b074a8921ae2e195451991eda987445bcae962
Packages
Published on omarchy-pkgs-aarch64 release rc:
omarchy 4.0.3rc4-1omarchy-settings 4.0.3rc4-1omarchy-mac-keyring 20260914-2
Qualification (this freeze)
- M1 Air (j313) encrypted btrfs: upgrade from 4.0.2-2, migrate, runtime smoke, reboot
[omarchy-aarch64]remains Optional TrustAll (rc4 posture)- Mic default-source quirk deferred as known issue for a later release
- Fresh install / M2 / stable promotion not part of this tag
Not included
- No
versionbump to final4.0.3 - No stable lane promotion
- No rc5 signing activation
v4.0.2-2
What's Changed
- Install the Apple Video Decoder stack on Apple Silicon by @kcirtapfromspace in #298
- Drive keyboard backlight from the ambient light sensor by @6abe in #303
- Recover Apple Silicon installs stranded before the ARM package sources policy by @megabyte0x in #354
- Keep the asahi mkinitcpio hook in the aarch64 package by @scottjones in #358
- Recover Wi-Fi after resume on Apple Silicon Macs by @bodhiblues in #255
- Bump version to match the release tags by @scottjones in #357
New Contributors
- @kcirtapfromspace made their first contribution in #298
- @6abe made their first contribution in #303
- @megabyte0x made their first contribution in #354
- @bodhiblues made their first contribution in #255
Full Changelog: v4.0.2-1...v4.0.2-2
v4.0.2-1
We’ve focused this release on reliable ARM installations and updates.
- #332 by @malik-na — Run the headless test suites on every push.
- #333 by @malik-na — Improve install-runner prechecks, logging, and documentation.
- #334 by @lzdelara — Allow root setup to refresh packaged Plymouth defaults.
- #345 by @malik-na — Keep the ARM Hyprland stack on compatible, signed official edge packages while other dependencies use the regular repositories.
- #346 by @malik-na — Bring the ARM package and Plymouth fixes together, with combined installer validation.
- #347 by @malik-na — Fix pacman Landlock failures under older nspawn filters and repeat installations reloading the live kernel firewall. Add hosted ARM checks for every PR, covering package sources, a clean install, and a repeat install.
We’ve verified that all CI checks and the hosted ARM install run pass. Apple boot and GPU behavior still need hardware testing.
v4.0.2
What's Changed
- Retire leftover Asahi alarm from wheel on existing installs by @malik-na in #258
- Allow a Mac-only pkgrel when building omarchy packages by @malik-na in #263
- fix: detect Apple Silicon lid state by @dl-alexandre in #249
- test: cover default keyring provisioning by @dl-alexandre in #253
- fix: escape guided setup resume config by @dl-alexandre in #244
- fix: retry first-run after user finalization failure by @dl-alexandre in #242
- fix: restore the ARM Obsidian preinstall by @dl-alexandre in #243
- fix: expand ARM mirror test paths by @dl-alexandre in #245
- fix: refresh ARM packages during upgrade by @dl-alexandre in #250
- fix: skip timezone prompt for configured zones by @dl-alexandre in #236
- Avoid repeated zram activation for additional users by @Skeptomenos in #259
- [Patch/shell] Moved calendar panel to the right by @tayowrld in #241
- fix(menu): show Mac F-key names for brightness keys in keybindings menu by @sambai-dev in #215
- Allow fresh Steam installs to bootstrap on Apple Silicon by @dl-alexandre in #251
- fix: keep optional recorder failures nonfatal by @dl-alexandre in #248
- fix: isolate Apple package build outputs by @dl-alexandre in #247
- Merge upstream Omarchy 4.0.2 into quattro by @scottjones in #308
New Contributors
- @sambai-dev made their first contribution in #215
Fixes from upstream
- Fix shell injection in theme and application installers by @mdisec, @Adolanium
- Fix Codex usage collection on version 0.149 by @orienw
- Fix migration failures on Bash 5.3 by @ryanrhughes
- Fix SSH hardening verification failing on OpenSSH 10.x by @ryanrhughes
- Prevent web app installers from creating nested directories via the app name by @Chessing234
- Security
- Require signed packages from the Omarchy repository by @ryanrhughes
- Harden CUPS printer discovery and administration by @mdisec
- Secure Plymouth and SDDM asset publication by @AFOliveira, @ErikMelton, @itz4blitz
- Secure Windows VM host mounts in Codex by @AFOliveira
- Prevent remote image injection in shell text elements by @ErikMelton
- Harden browser policy directory permissions by @acrogenesis
- Restrict sudoers rule for timezone updates by @omarchybot
- Validate web app URLs and escape desktop entry values by @bastidotnet, @Chessing234
- Harden existing SSH installations and disable password authentication by default by @acrogenesis, @ryanrhughes
- Close unprivileged input and SSH escalation paths by @acrogenesis, @fuchsblau, @ryanrhughes
Full Changelog: v4.0.1...v4.0.2
v4.0.1-1
What's Changed
- Retire leftover Asahi alarm from wheel on existing installs by @malik-na in #258
- Allow a Mac-only pkgrel when building omarchy packages by @malik-na in #263
Full Changelog: v4.0.1...v4.0.1-1
v4.0.1
What's Changed
- README: add some small details to help newcomers install faster by @harvitronix in #192
- Fix Asahi bootstrap admin handoff by @seanfreiburg in #193
- Fix Apple Silicon trackpad detection and boot race by @Skeptomenos in #184
- Restore the org home, and the Mac hero shot with it by @scottjones in #201
- Default the Mac Quattro upgrade to quattro and validate the tree before changes by @malik-na in #204
- Restore the merged work erased by the force-push (#192, #193) by @scottjones in #205
- Fix protected audio setup on Apple Silicon by @Skeptomenos in #186
- Persist the chosen keyboard layout's XKB pair so Hyprland picks it up by @kx0101 in #196
- Capture without holding Fn on Apple keyboards by @scottjones in #210
- document mac-specific keybindings and input defaults by @kx0101 in #198
- Drain stdin in the keyboard test's gum stub by @scottjones in #209
- Seed the SDDM user on first install by @kx0101 in #213
- Fix Quattro upgrade package pass on aarch64 (#208) by @malik-na in #214
- [Patch/login] Bring SDDM back to live by @tayowrld in #207
- Update README.md by @malik-na in #228
- Keep the Apple Silicon shell suite green by @dl-alexandre in #230
- Install prebuilt packages on the Quattro upgrade, not doomed AUR builds by @scottjones in #225
- Prefer the DCP panel backlight on Apple Silicon Macs by @skkumarsparsh in #219
- Install rtkit with the Apple Silicon audio stack by @skkumarsparsh in #221
- Read charge cycles from the battery's own sysfs directory by @skkumarsparsh in #224
- Round battery percentage to match the bar widget by @skkumarsparsh in #223
- Merge upstream Omarchy into quattro by @scottjones in #233
- Give Apple Silicon installs a UTF-8 locale by @scottjones in #234
- fix: run aarch64 optional apps from the right stage by @dl-alexandre in #238
- fix: preserve arguments in focus launch wrappers by @dl-alexandre in #239
- Fix Taildrop delivery paths by @dl-alexandre in #237
- Fix zram, DNS, and keyring gaps in the Apple Silicon install by @dl-alexandre in #229
New Contributors
- @harvitronix made their first contribution in #192
- @seanfreiburg made their first contribution in #193
- @Skeptomenos made their first contribution in #184
- @kx0101 made their first contribution in #196
- @dl-alexandre made their first contribution in #230
- @skkumarsparsh made their first contribution in #219
Full Changelog: v4.0.0...v4.0.1
v4.0.0
Omarchy Mac v4.0.0 — "Quattro"
Quattro is the Omarchy 4 generation, and the first release of Omarchy Mac to
fully target Apple Silicon. The Waybar/Walker/Mako/SwayOSD desktop is replaced
by a single Quickshell-based shell, Hyprland configuration moves to Lua, and
updates flow through omarchy update with per-user migrations. On top of that,
this release lands a first-class Apple Silicon story: a one-command install from
Asahi Alarm with full-disk encryption, a prebuilt aarch64 package repo, and
notch-aware hardware integration throughout.
Highlights
- New shell. A single Quickshell process replaces Waybar, Walker, Mako,
SwayOSD, and Fuzzel. The bar, launcher, menu, notifications, clipboard picker,
emoji picker, lock screen, and OSD now share one theme and one codebase. - Lua configuration. Hyprland config migrates from
hyprland.confto Lua;
themes are expressed in Lua and live in a singleshell.tomlcolor surface. - One-command Mac install.
omarchy-mac-setupcarries an Asahi Alarm image
to a booted, encrypted Omarchy desktop in one command. - Prebuilt aarch64 packages. Most of the default set installs from a
publishedaarch64repo instead of compiling for hours on the machine.
New shell (Quickshell)
- Bar with drag-and-drop widget placement, live inline config panel, and
keyboard navigation. - Interactive panels for power, network, Bluetooth, audio, display, weather,
and more — all keyboard-driven and themeable. - Native clipboard history with image support, master/detail layout, and
sensitive-content filtering; native emoji picker. - Notifications daemon (replaces Mako) with dedup, history, and countdown.
- Modular plugin system with third-party plugin sources and install/uninstall.
- Status widgets: stay-awake, night light, keyboard layout, system stats,
model-usage, Tailscale, Mullvad, and more. - Lock screen and idle handling moved into the shell (replaces hyprlock/hypridle).
Apple Silicon specifics (aarch64)
Install & disk
omarchy-mac-setup: one-command guided install from Asahi Alarm — hostname,
user, full-disk encryption, three reboots, ~15 minutes.- Full-disk encryption in place:
/bootmoved onto the EFI partition before
encrypting the btrfs root; resumable cryptsetup progress. - btrfs + Snapper snapshots with
@freshand@factoryrestore points;
omarchy snapshot restoreverified working on Apple Silicon. - Prebuilt
aarch64packages served from the omarchy-mac org, with graceful
fallback for packages that have no ARM build.
Display & notch
- Bar auto-sizes to the Apple notch (measured cutout, not the full strip), with
estimated cutouts for the MacBook Pro 14"/16" and Air. - Asahi notch area enabled by default; notch-friendly 34px bar height and side
layout; edge-aware popup alignment. - macOS-style notched sliders and a notched text-size slider in the display panel.
Hardware
hid_apple fnmode=1media keys on the top row, with an initramfs rebuild so
it survives reboot.Shift+ brightness keys drive the keyboard backlight (F1/F2 Mac layout).- Screen recording falls back to
wf-recorder— Apple GPUs can't run
gpu-screen-recorder; region picker shared between screenshot and recording. - Apple Studio/XDR display brightness via
asdcontrol. - Waits for
apple-drmbefore starting the compositor (fixes the blank
simpledrm boot); Apple Silicon audio stack; battery discovery that doesn't
assumeBAT0. - T2 Mac fixes: gmux backlight instead of Touch Bar, suspend/fan defaults;
Broadcom Wi-Fi quirk scoped to Intel Macs only.
Packages & apps
- Skips repo-unavailable/x86-only packages instead of failing migrations
(Obsidian, Pinta); buildsvoxtypefrom source sincevoxtype-binis
x86_64-only. omacutshipped by default; Emacs via theomarchy-emacsAUR package; Node
installed for aarch64.- Launcher/screen-share picker and browser PipeWire capture built for ARM.
- Spotify moved to an optional install.
Upgrading from 3.x
omarchy-upgrade-to-quattro-macperforms the in-place upgrade. Do not run
omarchy-upgrade-to-quattroon a Mac — it rewrites the mirrorlist to x86_64
mirrors and breaks pacman on aarch64.- The upgrade switches the checkout to
quattro, installs the Quattro stack,
wires/usr/share/omarchy, replaces the Hyprland config, retires
Waybar/Walker/Mako/SwayOSD, and moves networking from iwd to NetworkManager.
Removed
Waybar, Walker, Mako, SwayOSD, Fuzzel, the Qt5 stack, Kvantum, bluetui, and
impala, replaced by the unified shell.
@dhh @malik-na @scottjones @28allday @AksharP5 @DataDave-Dev @DiegoMirner @EFrMG @GebaRoanoke @InfeCtlll3 @JustMrMendez @KazeTachinuu @MoizIbnYousaf @OldJobobo @Pegorim @RushiChaganti @ShiroKSH @Vtorrealba @Zeus-Deus @acidkill @acrogenesis @akashgagda @almondsun @artfwo @atomashevic @bjarneo @brink-lab @bwynnyck @cupatea @dalmasluca @defer @e2escobar @ericvrp @fayimora @flavorjones @franciscoaccabral @glafeara @grantwiley @heymaikol @heyssh @husamemadH @jeremy @jitendradara12 @jzimdars @kevinmcconnell @khpark43 @lu-jim @lukehsiao @lukewalker2010 @markbus-ai @matjam @meirdick @monorkin @mwikala @nille @othondev @pkwagner @richardlences @robzolkos @ryanrhughes @s-gato @setiapam @shrijit37 @ssupt @stephentaylor-com @taxin-404 @thejamescollins @tmn73 @tobi @tyvsmith @virtualabishek @vivek7405 @yashranaway @yuters @zainsyedz
v3.3.3
This release focuses on Apple Silicon (aarch64) compatibility and fixes for omarchy-mac.
✨ New Features
- Zsh shell integration with modern fzf keybindings (Ctrl+R history, Ctrl+Alt+F file search, etc.)
- 1Password support - Pre-installed by default on aarch64 (#24)
- Widevine DRM support - Netflix and streaming services now work (#138)
- Screen recording improvements - Uses wf-recorder with gpu-screen-recorder fallback
- Webcam selection - Choose camera source when multiple webcams available
- Keyboard layout setup - Menu > Setup > Keyboard Layout for non-US keyboards (#36)
🔧 Fixes - Fix Fuzzel terminal launcher to use xdg-terminal-exec instead of hardcoded foot (#136, #142)
- Fix screenshots with grim and wayfreeze packages (#137)
- Fix AUR fallback when pacman install fails
- Fix omarchy-update-system-pkgs syntax errors preventing updates (#99)
- Fix omarchy-ai-skill.sh installation script
- Fix channel switcher and Update > Firmware (PR #140)
- Updated README with clearer instructions (#91)
📦 Package Changes
Added: grim, wayfreeze, widevine (aarch64)
🐛 Issues Closed
This release closes 8+ issues including #24, #36, #91, #94, #99, #136, #137, #138, #142
🙏 Contributors
@uschi909, @malik-na, and the upstream Omarchy team
Full Changelog: v3.3.2...v3.3.3
What's Changed
Full Changelog: v3.3.0...v3.3.3