v3.0.2

Existing installations can upgrade as per-normal using Update > Omarchy.

New installations should download the fresh, all-inclusive ISO: https://iso.omarchy.org/omarchy-3.0.2.iso.

ISO SHA256: 8d136a99d74ef534b57356268e5dad392a124c7e28487fc00330af9105fc6626

What's Changed

• Fix osaka jade theme for Ghostty by @dhh
• Adjust Ghostty scrollfactor by @dhh
• Limit matching pattern of omarchy-launch-or-focus to prevent incorrect matches by @ryanrhughes
• Improve theme-set-vscode to support jsonc and respect symlinks by @OmarSkalli
• Hide hyperland cursor while typing by @js
• Fix Matte Black theme Ghostty and vscode configs by @tahayvr
• Fix ghostty config comment typo by @John-Lin
• Add Update > Hardware > Audio for restarting pipewire service by @dhh
• Install libyaml before attempting to install ruby by @vrinek
• Add Helium browser to supported browsers list in omarchy-launch-webapp by @Furyfree
• Add Apple SPI keyboard support for MacBook8,1, MacBook9,1, MacBook10,1 by @e-minguez + @joelgaff
• Add support for Broadcom BCM4331 chipset alongside BCM4360 for MacBooks by @mrlarsendk
• Fix for '(null)' display on AirPod source selection by @shawnyeager
• Fix omarchy-tui-install not keeping $TERMINAL by @djordje
• Use output display or region geometry to record by @iamobservable

ISO Updates

• Add missing alsa-firmware by @ryanrhughes
• Fix hanging issue for normal boot when using Ventoy by @ryanrhughes
• Update to archiso v86 by @ryanrhughes
• Update to archinstall v3.0.11 by @ryanrhughes
• Fix invalid keyboard options by @ryanrhughes + @rixlabs + @CastilhoBorges

Full Changelog: v3.0.1...v3.0.2

v3.0.0

What changed?

Omarchy 3.0 is a major upgrade for new installations and a wonderful level-up for existing users. The new ISO doesn't require internet at all, and you can install it in less than two minutes on the fastest systems.

You can now also install Omarchy on most pre-M MacBooks with support for keyboards, wifi, and the T1 and T2 security chips. This is a decade-long hardware portfolio that we're trying to cover as well as we can out of the box. There may still be issues and trade-offs, so only install this on hardware that you're okay experimenting with!

Existing installations can upgrade as per-normal using Update > Omarchy. New installations should download the fresh, all-inclusive ISO before beginning: https://iso.omarchy.org/omarchy-3.0.1.iso. This is a 7GB ISO that includes the entire system for offline installation (just 1/10th the size of macOS!).

Note: Ghostty compatibility requires Ghostty 1.2.0, which is still not released on the Arch repository. Please hold off on using that until it is (or install the 1GB+ dev version under ghostty-git from AUR). Hopefully @mitchellh will get it out soon!

New super-fast installation ISO

• Add everything needed for new all-inclusive ISO that doesn't need internet by @ryanrhughes
• Add new styled install flow with centered logo and tailed logging by @ryanrhughes
• Add option to upload install logs to 0x0.st if installation fails by @ryanrhughes
• Add invitation to setup wifi and update system on new ISO installations by @dhh
• Add precompiled lazyvim installation for nvim by @ryanrhughes

MacBook Compatibility

• Add support for T2 macs with custom kernel and drivers by @ryanrhughes + @nunix
• Add compatibility with T1 MacBook keyboards so they work on the decryption screen by @joelgaff
• Add compatibility with Broadcom BCM4360 MacBooks (2013-2015) to get working wifi by @ryanrhughes

New features

• Add screen recording indicator to the top bar when recording (clicking will stop) by @eifr + @dhh
• Add option to sign into Google account for settings sync in Chromium via Install > Service > Chromium Account by @hjanuschka
• Add omarchy-launch-or-focus to either launch or focus an app and apply it to several binding defaults by @v-oleg
• Add default ~/Work directory (with mise configuration for ./bin PATH to avoid security issue) by @ryanrhughes
• Add option to view PKGBUILD before installing AUR packages on alt+b under Install > AUR by @rajayonin
• Add support for zoom meeting links in the zoom web app by @ATeal
• Add support for changing terminal and editor system-wide in ~/.config/uwsm/default (see Setup > Defaults) by @eifr + @dhh
• Add Install > Terminal for picking between Alacritty, Ghostty, Kitty as your fully-themed default terminal by @dhh
• Add Zig language server when installing from Install > Development by @DoKoB0512
• Add Update > Branch to switch between master and dev branch (don't use dev unless you're doing actual development or testing — it won't be stable!) by @dhh
• Add Walker service back to get faster application launcher and Omarchy Menu start times (if you see any memory leaks, use Update > Process > Walker to restart — this will be fixed proper in Omarchy 3.1).

New hotkeys

• Add Alt + Shift + L to copy current URL from Chromium and the frameless webapps by @jankeesvw
• Add Ctrl + Super + S (or Trigger > Share) and for using LocalSend to share clipboard/file/folder quickly by @guilhermetk
• Add Super + Backspace to toggle transparency on/off for any window by @dhh
• Add Super + Shift + B to start browser in private mode by @kodnin
• Add Super + Ctrl + Tab to go to the former workspace by @zaborowskimichal
• Add Alt + F11 to toggle full width on a window by @c4software
• Add calculator key binding for default calculator by @SamrudhNelli

Aesthetics

• Add blurred theme background to the lock screen by @dhh
• Add theme switching for VS Code by @OmarSkalli
• Add theme switching for eza by @sgruendel
• Add theme switching for Kitty terminal by @vyrx-dev
• Add theme switching for Brave (with a slight delay until next Brave release where it'll be instant) by @hjanuschka + @dhh
• Add browser theme switching based on upcoming --refresh-platform-policy flag shipping in Chromium 141 and next Brave by @hjanuschka
• Add ~/.config/hypr/looknfeel.conf to new installations to suggest ways to change the Hyprland aesthetics by @dhh
• Add Style > Hyprland to tweak Hyprland look'n'feel from the menu by @med502

Bug fixes

• Fix waybar flashing or disappearing after update-available icon kicked off an update by @dhh
• Fix setting gnome dark mode and themes on first install by @dhh
• Fix audio output switch should only move between available outputs by @elpritchos
• Fix config error warning from Hyprland 0.51 yanking workspace_swipe by @dhh
• Fix incompatibility with freetype2 update and plymouth by @ryanrhughes
• Fix that default hyprsunset config shouldn't turn off until 7am by default by @tmkn
• Fix remove --freeze from hyprshot again as it was unstable by @dhh
• Fix cursor was visible during screensaver by @alexperreault
• Fix updating time + tz should give you feedback while its happening by @dhh
• Fix fcitx5 issue with other languages in Obsidian by running it with --wayland-ime by @ashutoshbw
• Fix screenrecording on Intel should now use accelerated graphics by @eifr
• Fix gum should be available to the install script as soon as possible so we can offer retry on failures by @dhh
• Fix screensaver would persists in workspace after using other workspaces by @manuel1618
• Fix power profile not opening after folks had installed Python via mise by @dhh
• Fix the temporary patch to force Ruby to build with gcc14 by @dhh

Visuals

New super fast ISO installer

Lock screen now has blurred out background image

Ghostty as a fully-themed terminal option

Live VS Code theming

Themes need to include vscode.json, like this, to enable the live themeing.

Screen recording dot in the top bar

Clicking the dot will stop the recording too.

View PGKBUILD before installing AUR package

New Contributors

• @elpritchos made their first contribution in #1555
• @eifr made their first contribution in #1561
• @denisu14 made their first contribution in #1596
• @tmkn made their first contribution in #1638
• @joelgaff made their first contribution in #1313
• @SamrudhNelli made their first contribution in #1585
• @ATeal made their first contribution in #1542
• @kodnin made their first contribution in #1324
• @hjanuschka made their first contribution in #1251
• @v-oleg made their first contribution in #925
• @jankeesvw made their first contribution in #1458
• @OmarSkalli made their first contribution in #800
• @sgruendel made their first contribution in #1242
• @gustavokurtz made their first contribution in #1689
• @vyrx-dev made their first contribution in #1296
• @DoKoB0512 made their first contribution in #1718

Full Changelog: v2.1.2...v3.0.0

v2.1.2

What changed?

• Fix unstyled decryption screen on new installations made in the last day by @ryanrhughes
• Fix 6Ghz Wi-Fi compatibility on existing installations with a migration by @dhh
• Fix Intel graphics acceleration on existing installations with a migration by @dhh

Full Changelog: v2.1.1...v2.1.2

v2.1.1

What changed?

• Add screenrecordings with audio on ALT + SHIFT + PRINT for region and CTRL + ALT + SHIFT + PRINT for full screen and to Capture > Screenrecording by @dhh
• Add support for 6GHz Wi-Fi via wireless-regdb by @eclecticc
• Add visual feedback when switching between audio outputs on Super + Mute by @cluah
• Add Update > Password for setting a new LUKS drive encryption password and setting user password by @dhh
• Add Install > Development > Clojure by @naxels
• Add PHP Debugger as part of PHP install by @roberto-aguilar
• Add new ship-at-sea background for Matte Black theme by @dhh
• Add numlock by default in new hypr/input.conf files by @bftanase
• Fix ristretto cursor inside selection coloring by @ollymarkey
• Fix firewall wouldn't stay on after a restart by @martinmose
• Fix screenshots should happen against a frozen screen by @rsd
• Fix omarchy-install-docker-dbs should work from cli with parameters by @roberto-aguilar
• Fix Install > Docker DB > PostgresSQL should use pgsql17 by @aliismayilov
• Fix Install > AI > Gemini should source from AUR by @keyfer
• Fix Install > Gaming > Minecraft should source from AUR by @roberto-aguilar
• Fix Install > Package/AUR should show backtrace when package fails to install by @dhh
• Fix VPN DNS resolution in DHCP mode by @jardahrazdera
• Fix new-terminal cwd when your current directory has spaces by @dhh
• Fix waybar clock should use local correct names for the day/month by @arni1981
• Fix Firefox opacity problems in some situations by @typeshaper
• Fix YouTube opacity setting for all subdomains by @mgbaron
• Fix mako config duplication by @pipetogrep
• Fix git configs should be kept in ~/.config/gitconfig by default by @esteban_ba
• Fix video acceleration on Intel GPUs by @eclecticc
• Fix accessing direct menus, like system and theme, should exit directly by @iccodes
• Fix mDNS resolution for .local domains for CUPS printer setup by @jardahrazdera

New Contributors

• @ncr made their first contribution in #1376
• @mgbaron made their first contribution in #1480
• @rsd made their first contribution in #1471
• @Esteban-Bermudez made their first contribution in #1459
• @martinmose made their first contribution in #1429
• @bftanase made their first contribution in #1443
• @typeshaper made their first contribution in #1427
• @ollymarkey made their first contribution in #1426
• @arni1981 made their first contribution in #1380
• @keyfer made their first contribution in #1517
• @aliismayilov made their first contribution in #1524
• @naxels made their first contribution in #1238
• @cluah made their first contribution in #1474
• @eclecticc made their first contribution in #1368
• @mrjoedang made their first contribution in #1152
• @iccodes made their first contribution in #1100

Full Changelog: v2.1.0...v2.1.1

v2.1.0

What changed?

• Add Cloudflare-hosted Omarchy Mirror as the default place to get Arch core/extra/multilib packages by @dhh
• Remove chaotic-aur as a default setup now that we have our own package repo by @dhh
• Add omarchy-pkg-add/drop/present/missing helper commands for migrations in particular by @dhh
• Add omarchy-cmd-present/missing helper commands for migrations in particular by @dhh
• Add Install > Service > Bitwarden as an alternative to 1pw by @crbelaus
• Add Install > Editor > Emacs by @spdawson
• Add Update > Hardware > Wifi/Bluetooth to unblock the modules via rfkill by @dhh
• Add Samba drive support to file manager by @chantastic
• Fix omarchy-migrate when migrations fail so they can be skipped by @Gazler
• Fix bring back ttf-ia-writer now that the package has been sorted by @dhh + @ryanrhughes
• Fix trailing slash in Omarchy pkg repo declarations by @dhh
• Fix battery monitor math by @pipetogrep
• Fix screensaver should pause for 2 seconds after each completed animation by @oppegard
• Fix Install > AI > Ollama to install GPU-accelerated versions where possible by @valbertoenoc
• Fix Omarchy Update: AUR should only upgrade AUR packages by @dhh
• Fix Alacritty adding its own opacity controls on top of Hyprland by @dhh
• Fix Kanagawa transparency being too high with default background on the terminal by @dhh
• Fix missing icons for OS Age + Uptime in About by @theamit-969
• Fix qt5-wayland should be installed so KeepassXC, Nextcloud, Sqlite Browser, and other apps display correctly by @roelandmoors
• Fix JetBrains font installed by default should be Nerd Font version by @ankurkotwal
• Fix steam + retroarch could idle during gaming when using joypads by @JordanAnthonyKing
• Fix wrong navigation icons used by Nautilus by @pipetogrep
• Fix that a failed installation should offer an automatic retry rather than require manual command by @dhh
• Fix Framework Laptop 13 audio input was misconfigured by @ryanrhughes + @dhh
• Fix using Omarchy Package Repository for most optional installs too, like Cursor, Dropbox, VSCode, Claude, Crush, opencode by @ryanrhughes + @dhh
• Fix remove trailing slash from repository URL in pacman.conf setup by @szcharlesji
• Fix DNS migration to handle UseDNS=no in network files by @jardahrazdera

This release completes the transition to having all package and mirror activity hitting our own setup behind Cloudflare 🎉

New Contributors

• @szcharlesji made their first contribution in #1141
• @JordanAnthonyKing made their first contribution in #1303
• @cossssmin made their first contribution in #1245
• @chantastic made their first contribution in #1327
• @pipetogrep made their first contribution in #1114
• @rickdotnet made their first contribution in #1259
• @ramtinJ95 made their first contribution in #1084
• @crbelaus made their first contribution in #1044

Full Changelog: v2.0.5...v2.1.0

v2.0.5

What changed?

• Fix package repository order so Arch defaults come before Omarchy Package Repository by @dhh
• Fix Omarchy branch name should be exposed in the About screen by @dhh
• Fix node.js is needed for a full Laravel installation by @roberto-aguilar
• Fix new installs should use woff2-font-awesome instead of ttf-font-awesome per Font Awesome 7.0 by @dhh
• Fix strange case where walker-bin went missing by @dhh
• Fix Waybar shouldn't restart after unlock now that we've fixed the stacking problem by @dhh
• Fix snapper usage for custom btrfs setups by @michielryvers + @ryanrhughes

New Contributors

• @roberto-aguilar made their first contribution in #1201
• @michielryvers made their first contribution in #1160

Full Changelog: v2.0.4...v2.0.5

v2.0.4

What changed?

• Fix pinning package no longer needed after we shrinked the Omarchy repo by @dhh
• Fix iwd service shouldn't start during installation by @dhh
• Fix keyboard layout at install by @bastnic in #1188
• Fix clicking on the battery icon should open the power menu by @cstrickjacke in #1178

New Contributors

• @bastnic made their first contribution in #1188
• @cstrickjacke made their first contribution in #1178

Full Changelog: v2.0.3...v2.0.4

v2.0.3

What changed?

• Fix top bar would disappear when running upgrade from the update-available icon by @dhh
• Fix phantom update-available icon in top bar showing up due to git network errors by @dhh
• Fix migration to add --working-directory to bindings.conf if its already there by @dhh
• Fix non-kosher use of pacman -Sy that would cause partial system updates by @dhh

Full Changelog: v2.0.2...v2.0.3

v2.0.2

What changed?

• Fix black-screen-of-death installs following abseil-cpp package release at 2025-08-26 22:15 UTC that broke installs by @dhh
• Fix About info display by @tahayvr
• Fix font size for About when system font size has changed by @dhh

Update as per usual using Update > Omarchy from the Omarchy Menu.

Fixing black-screen-of-death installs

If you installed Omarchy via the ISO between 2025-08-26 22:15 UTC and 2025-08-27 12:50 UTC, you'll likely have hit the black-screen-of-death after installation. You can fix it with these steps:

1. CTRL + ALT + F2
2. Login with your credentials
3. curl -fsSL https://omarchy.org/patch/pin-abseil-cpp | bash

This will restore the working version of abseil-cpp and restart your system. Now you're back in business!

Full Changelog: v2.0.1...v2.0.2

v2.0.1

What changed?

• Fix AMI bios bricking bug by @ryanrhughes
• Fix omarchy-launch-browser and omarchy-launch-webapp for folks using Nix home manager by @manofcolombia
• Fix Update > Omarchy should use our new icon instead of Arch by @tahayvr
• Fix Remove > Web App and Remove > TUI for removing multi-word entries by @jopesh
• Fix Remove > Web App and Remove > TUI should use an x instead of checkmark for selection by @hipsterusername
• Fix emoji picker description in keybindings overview by @AdiY00
• Fix that all chromium-based and firefox-based browser should have the same transparency rules by @joshleblanc + @dhh
• Fix that omarchy-icon font shouldn't should up as an option in the Style > Font menu by @WToa
• Fix workspace tabbing should use bindd by @arcbjorn
• Fix old installations still had About, Activity, Audio Settings apps in launcher that we've moved to Omarchy Menu by @dhh

New Contributors

• @manofcolombia made their first contribution in #1076
• @hipsterusername made their first contribution in #1104
• @meerzulee made their first contribution in #1103
• @WToa made their first contribution in #1101
• @arcbjorn made their first contribution in #1098
• @AdiY00 made their first contribution in #1091
• @jopesh made their first contribution in #1087
• @joshleblanc made their first contribution in #1090

Full Changelog: v2.0.0...v2.0.1