Skip to content

Releases: basecamp/omarchy

v3.0.0

17 Sep 18:53
@dhh dhh
v3.0.0
cf41eca
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
v3.0.0 Latest
Latest

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

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

screenshot-2025-09-15_20-04-42 screenshot-2025-09-15_20-05-11 image

Lock screen now has blurred out background image

20250915_103532

Ghostty as a fully-themed terminal option

image

Live VS Code theming

screenshot-2025-09-15_19-31-52

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

Screen recording dot in the top bar

image

Clicking the dot will stop the recording too.

View PGKBUILD before installing AUR package

image

New Contributors

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

Contributors

mitchellh, dhh, and 26 other contributors
Assets 2
Loading

v2.1.2

10 Sep 15:33
@dhh dhh
v2.1.2
16460b5
Compare
Choose a tag to compare
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

Contributors

dhh and ryanrhughes
Loading

v2.1.1

09 Sep 19:37
@dhh dhh
v2.1.1
477ec35
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

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

Contributors

iccodes, dhh, and 18 other contributors
Loading

v2.1.0

31 Aug 14:12
@dhh dhh
v2.1.0
57a9a1a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

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

Contributors

dhh, oppegard, and 16 other contributors
Loading

v2.0.5

28 Aug 09:16
@dhh dhh
v2.0.5
cd378a5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

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

Contributors

dhh, ryanrhughes, and 2 other contributors
Loading

v2.0.4

28 Aug 05:11
@dhh dhh
v2.0.4
950f1f0
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

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

Contributors

dhh, bastnic, and cstrickjacke
Loading

v2.0.3

27 Aug 14:12
@dhh dhh
v2.0.3
d94715d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

Contributors

dhh
Loading

v2.0.2

27 Aug 10:53
@dhh dhh
v2.0.2
8cbd6be
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

Contributors

dhh and tahayvr
Loading

v2.0.1

26 Aug 10:32
@dhh dhh
v2.0.1
3affd55
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
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

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

Contributors

dhh, ryanrhughes, and 9 other contributors
Loading

v2.0.0

25 Aug 14:11
@dhh dhh
v2.0.0
acc1e2f
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
Compare
Choose a tag to compare
v2.0.0

What changed?

Major additions

  • Add new Omarchy ISO online installer using the Omarchy Configurator front-end to archinstall by @Torxed + @dhh + @ryanrhughes + @jardahrazdera + @tahayvr
  • Add new Omarchy Package Repository (OPR) as replacement for AUR hosted on Cloudflare for all default packages and split Install > AUR out from Install > Package to avoid AUR DDoS fallout by @ryanrhughes + @dhh
  • Add Limine/Snapper setup which snapshots before omarchy-update and allow for rollbacks in Limine bootloader by @ryanrhughes.
  • Add Omarchy Chromium micro-fork that gives us live theme switching in the browser without having to close all windows by @hjanuschka
  • Add minimal Starship prompt to terminal by @tobi + @dhh
  • Add Install > TUI as a new TUI-wrapper like Install > Web App by @dhh + @ryanrhughes
  • Add new Omarchy icon to About and top-left Omarchy Menu icon by @tahayvr
  • Add Setup > DNS to easily use Cloudflare, DHCP, or Custom DNS server across the system by @jardahrazdera

Minor additions

  • Add omarchy-launch-browser and omarchy-launch-webapp so we can respect the default browser across the system by @ankurkotwal + @ryanrhughes
  • Add multiselect using tab to Install > Package/AUR and Remove > Package by @jardahrazdera + @dhh
  • Add network check to ensure AUR is available before trying any AUR operations by @dhh
  • Add sticky cwd when launching new terminal windows off an existing one by @halilozercan + @dhh
  • Add Tailscale TUI + Tailscale Web Admin webapp to Tailscale installer by @ryanrhughes + @dhh
  • Add higher sudo fail threshold (10 instead of 3) and omarchy-reset-sudo for when you've fat fingered your sudo password so many times you're locked out by @manuel1618
  • Add System > Screensaver to start screensaver and make Toggle > Screensaver control whether it should start automatically by @manuel1618
  • Add Style > Screensaver and Style > About to allow changing the ASCII art used for screensaver and fastfetch by @dhh
  • Add Phoenix under Install > Development > Elixir by @johanneserhardt
  • Add MongoDB under Install > Development > Docker DB by @valbertoenoc
  • Add removal of orphan packages on Omarchy Update by @dhh
  • Add multi-select removal of web apps under Remove > Web Apps by @dhh
  • Add img2jpg, img2jpg-small, img2png functions for turning any image into formats usable for web or backgrounds by @dhh
  • Add Disk Usage TUI using dust by @tobi + @dhh
  • Add QR code to join the Discord for help when the installer breaks by @uigig44
  • Add new wallpapers to default themes by @Swarnim114 + @gthelding + @guilhermetk

New hotkeys

  • Add Ctrl + Super + E to bring up Walker Emoji selector by @dhh
  • Add Super + Mute for switching between audio outputs by @chriopter
  • Add Ctrl + Alt + Delete for closing all windows by @chriopter
  • Add ALT + [Volume/Brightness Up/Down] to apply 1% increments by @zaborowskimichal
  • Add Super + Tab and Super + Alt + Tab to move forward and backward through workspaces by @iamobservable
  • Add power button override to bring up Omarchy Power Menu instead of turning off computer by @v3rtx

Fixes

  • Fix Zoom's buggy native app by replacing it with a web app by @dhh
  • Fix use wf-recorder for screen recordings when on Intel graphics bt @alansikora
  • Fix font name setting for waybar + swayosd by @eamonburns
  • Fix Waybar stacking by not using SIGUSR1 or SIGUSR2 anywhere by @ryanrhughes + @dhh
  • Fix wifi + bluetooth getting turned off from sleep/low battery when opening Setup > Wi-Fi and Setup > Bluetooth by @dhh
  • Fix show keybindings for some key combinations by @r3ap3r2004
  • Fix presentation of fzf finder options in pkg installers by @rajayonin + @kataqatsi
  • Fix Setup > Fido2 to work for all of polkit and Setup > Fingerprint to only ask for fingerprint not also password on polkit by @ryanrhughes
  • Fix Brave to use wayland and use Chrome-like opacity by @dhh
  • Fix Walker should close before screensaver starts by @robzolkos
  • Fix window sizing for JetBrains editors by @MikeVeerman, @sailoz, @vlofgren
  • Fix all system windows that float should use the same 800x600 size by @dhh
  • Fix Walker memory leak by removing service for now by @dhh
  • Fix keybindings for resizing active windows to work with non-US keyboard layouts by @manuel1618
  • Fix USB auto-suspend issues after sleep/suspend by @jonnyace
  • Fix problems for some with power controls by adding missing dependency @dhh
  • Fix firewall rules to allow non-default docker bridge networks by @samuelpecher
  • Fix all default AUR packages by switching them over to the OPR by @dhh
  • Fix lock screen flashing content of screen on wake from sleep by @remshams
  • Remove "bare mode" as it violated the Omakase Computing Doctrine by @dhh

Updating to 2.0

Existing installations can upgrade by running Update > Omarchy from the Omarchy Menu (or omarchy-menu if they're still on a version predating that). Everything will be brought up to the latest EXCEPT the switch to limine bootloader and snapper snapshot restoring. That is currently only available to new installations, but we will release instructions on how to make that transition manually soon.

New ISO installations

New installations should use the new online ISO installer: https://iso.omarchy.org/omarchy-online.iso

image

New Chrome theme matching

Our Omarchy Chromium micro-fork now matches colors on theme changes:

image

New Starship prompt

image

"Borrowed" from @tobi

New Omarchy icon

image

Designed by @tahayvr

New Emoji Picker

In addition to the XCompose quick emojis, you can now search the entire range of emojis with Ctrl + Super + E, and copy to clipboard:

image

New QR code to join Discord if installer breaks

image

New DNS selector

image

New Contributors

Read more

Contributors

tobi, lsc, and 45 other contributors
Loading