Releases: basecamp/omarchy
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
andomarchy-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
andSuper + 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

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

New Starship prompt

"Borrowed" from @tobi
New Omarchy icon

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:

New QR code to join Discord if installer breaks

New DNS selector

New Contributors
- @zaborowskimichal made their first contribution in #670
- @ericrswanny made their first contribution in #585
- @not-NEK0 made their first contribution in #692
- @dylanbr made their first contribution in #684
- @Swarnim114 made their first contribution in #707
- @bcye made their first contribution in #746
- @r3ap3r2004 made their first contribution in #715
- @kevinmcconnell made their first contribution in #812
- @Gazler made their first contribution in #889
- @kataqatsi made their first contribution in #858
- @MikeVeerman made their first contribution in #888
- @robzolkos made their first contribution in #701
- @valbertoenoc made their first contribution in #972
- @saeedvaziry made their first contribution in #917
- @jonnyace made their first contribution in #906
- @iamobservable made their first contribution in #874
- @Chris24680 made their first contribution in #863
- @rajayonin made their first contribution in #852
- @vlofgren made their first contribution in #823
- @jardahrazdera made their first contribution in #822
- @lsc made their first contribution in #820
- @vaibhav-mattoo made their first contribution in #807
- @luigig44 made their first contribution in #795
- @v3rtx made their first contribution in #769
- @rez1coder made their first contribution in #990
- @domingo2000 made their first contribution in #760
- @samuelpecher made their first contribution in #679
- @johanneserhardt made their first contribution in #676
- @chriopter made their first contribution in #941
- @taylorminton made their first contribution in #1003
- @eamonburns made their first contribution in https://github.com/basecamp/omarc...
v1.13.0
What changed?
- Add Install > Gaming to ease installation of Steam, RetroArch, and Minecraft by @dhh
- Add Install > Development to ease installation of many major development environments by @dhh, @fhammerschmidt, @florianbeer, @c4software, @abdellahrk, @devmobasa, @Macho0x
- Add Install > Editor options for Sublime Text + Helix by @dhh
- Add Install > Service with options for Dropbox + Tailscale setup by @dhh
- Add Discord as a default web app by @dhh
- Add system-wide
~/.local/share/omarchy/bin
to PATH and OMARCHY_PATH by @ryanrhughes + @dhh - Add guard against installing Omarchy on anything but a fresh vanilla Arch on x86_64 (but option to override) by @dhh + @daltonbr
- Add Cloudflare (with Google as backup) as the default DNS setup by @dhh
- Add two new backgrounds for Osaka Jade by @Justikun + @dhh
- Add vim navigation hotkeys + description hiding to Install/Remove > Package by @maxguzenski
- Add omarchy-version command to get the current Omarchy release version (from git tag) by @sailoz
- Add noscreenshare windowrule for 1password so it'll be blacked out during screenshare by @alexperreault
- Fix sleep wouldn't lock screen on some installations due to path issue by @dhh
- Fix common flakiness with SSH by default by @dhh
- Fix Chromium save dialogue getting too big by @dhh
- Fix About font size if system was changed by @sailoz
- Fix Walker config to only override values where we differ from defaults by @ryanrhughes
- Fix order of includes in default
~/.config/hypr/hyprland.conf
so user edits take precedence by @dhh - Fix that Omarchy logo would wrap on some terminal interactions by @dhh
- Fix missing icon for Audio Settings (wiremix) in application launcher by @dhh
- Fix boot taking forever because systemd was waiting for a network interface to come online by @ryanrhughes
- Fix mise paths not being available systemwide by adding them to uwsm by @ryanrhughes
- Fix update-available icon would hang around after update in Waybar by @LeonardoTrapani
Updating
This release includes a revamp of the PATH and how Omarchy finds its bins. It's very important that when you are asked to relaunch Hyprland, that you do so, and then run Omarchy > Update (or omarchy-update
) again afterwards. That'll ensure everything is migrated correctly.
Otherwise you can just update by clicking the update-available icon next to the clock (if you see that), by running Update > Omarchy from the Omarchy Menu, or by omarchy-update
on the cli.
New Contributors
- @RaphaelKimmig made their first contribution in #564
- @maxguzenski made their first contribution in #569
- @florianbeer made their first contribution in #594
- @fhammerschmidt made their first contribution in #598
- @devmobasa made their first contribution in #615
- @Macho0x made their first contribution in #595
- @alexperreault made their first contribution in #663
Full Changelog: v1.12.1...v1.13.0
v1.12.1
What changed?
- Add Install > AI with suggestions for claude, gemini, LM studio, crush, and opencode by @dhh
- Add Install > Style to group Theme/Font/Background like we do in Setup > Style by @dhh
- Add Update > Process to make the omarchy-restart-* scripts available via the Omarchy menu by @dhh
- Add highlight of current selection in Style > Font, Style > Theme, Setup > Power Profile by @dhh
- Fix missing comma in windowrule for about by @dhh
- Fix margin for the top bar tray by @dhh
- Fix upgrade-icon wouldn't launch omarchy-upgrade due to missing path by @dhh
- Fix that Update/Install/Remove options from the menu should not exit until user has pressed a key by @dhh
- Fix that omarchy-update run in the terminal should not have presentation output around it by @dhh
- Fix About page used a freaking windows icon for OS by @dhh
New Contributors
Full Changelog: v1.12.0...v1.12.1
v1.12.0
What changed?
- Add Osaka Jade theme to default collection by @Justikun
- Add Style > Font as a walker interface in Omarchy menu rather than shelling out by @dhh
- Add Style > Font changes will now be reflected in Waybar, SwayOSD, fontconfig as well by @dhh
- Add Install > Editor section in Omarchy menu with common options for VSCode, Cursor, and Zed by @dhh
- Add Install > Font with options for Meslo, Fira Code, Victor Code, Bitstream Vera common options by @dhh
- Add Setup > Power Profiles to change powerprofilectl options via Omarchy menu by @dhh
- Add transcode-video-1080p, transcode-video-4k, transcode-png2jpg functions for common media workflows by @dhh
- Fix wrong workspace number descriptions in hyprland default binds by @pastr
- Fix broken multicast dns config for printers by @oppegard
- Fix that escaping out of Install > Package and Remove > Package shouldn't ask for sudo in Omarchy menu by @dhh
- Fix the stuck Omarchy menu by upgrading to latest Walker and restarting the service by @dhh
- Fix Remove > Theme selector wasn't working right by @gyllen + @xadcv
- Fix screensaver should always use a black background and hide the cursor by @manuel1618
New Osaka Jade theme
Install > Editor

Style > Font

New Contributors
- @Justikun made their first contribution in #514
- @xadcv made their first contribution in #505
- @pastr made their first contribution in #522
- @oppegard made their first contribution in #521
- @manuel1618 made their first contribution in #526
- @gyllen made their first contribution in #533
Full Changelog: v1.11.0...v1.12.0
v1.11.0
What changed?
- Add new unified Omarchy menu system by @dhh
- Add touchpad gestures to Chrome by @ryanrhughes
- Fix picture-in-picture window positioning by @ElFitaFlores + @dhh
- Fix hypridle screensaver starting after actually 2.5 minutes by @rmacklin
- Fix hyprpicker should toggle not stack by @dhh
- Fix error handling in fido2 setup by @DavidHoenisch
Update using omarchy-update
. From this version forward, you can update via the Omarchy menu.
The old omarchy
TUI has been replaced by omarchy-menu
. You can start it using Super + Alt + Space
or from the new icon in the upper left corner.
Note: The ~/.config/hypr/hyprland.conf
has been divided into several dedicated files. The update process will ask you to confirm that you want the new layout (which enables some direct editing via the new menu system). If you say yes, you'll be reset to Omarchy defaults, but your own settings will still be in ~/.config/hypr/hyprland.conf/bak.$timestamp
, and you can just copy them to the right place.
New unified Omarchy menu system
The old Omarchy TUI has been retired, a ton of the commands have been reworked, and we now have a single way to control just about everything about the system. See this introduction video: https://www.youtube.com/watch?v=Cft6mZDzIng
New Contributors
- @DavidHoenisch made their first contribution in #494
Full Changelog: v1.10.0...v1.11.0
v1.10.0
What changed?
- Add toggling nightlight display temperature via hyprsunset on
SUPER + CTRL + N
by @JaxonWright - Add auto-discovery of network printers by @rockorager + @dhh
- Add human descriptions to dynamically discovered keybindings cheat sheet (
SUPER + K
) by @spdawson - Add support for accessing Android files via file manager when phone is connected via USB by @erik-brueggemann
- Add
OMARCHY_REPO
options to boot.sh for testing custom repos by @ryanrhughes - Fix new installations should already have the migration state set for that release by @dhh
- Fix screensaver should start on all displays by @precision
- Fix screensaver should use a bigger font to be less CPU intensive by @precision
- Fix screensaver should wait 2.5 minutes instead of 1 minute before starting automatically by @dhh
- Fix
refresh-compose
function should just be aomarchy-refresh-xcompose
like everything else by @dhh - Fix keybindings cheat sheet would only show the first 50 elements by @abenz1267 + @dhh
- Fix battery warning notification to stick around for 30 seconds instead of 2 to be harder to miss by @dhh
- Fix missing waybar update needed to get the new-version icon in the top bar by @dhh
New Contributors
- @rosscondie made their first contribution in #464
- @erik-brueggemann made their first contribution in #466
Full Changelog: v1.9.0...v1.10.0
v1.9.0
What changed?
- Add starting screensaver after 1 minute by default and include it in the power menu by @dhh
- Add invitation to update Omarchy when a new version is available via waybar icon by @dhh
- Add invitation to reboot the system when the Linux kernel has been upgraded after
omarchy-update
by @dhh - Add faded numbers for empty workspaces by @brink-lab
- Add icon themes using Yaru colors to all default themes by @dhh
- Add option for all themes to put a custom icon theme name in
icons.theme
file by @dhh - Add inline diff when config files are updated with new Omarchy defaults by @dhh
- Add backup timestamps to omarchy-refresh-* to prevent clobbering by @ardavis
- Fix (again) that Waybar would stack in certain situations by @ryanrhughes
- Fix power menu options showing sorting codes in languages other than English by removing them (walker doesn't need them) by @dhh
- Fix migration for adding file finder to Walker by @ardavis
- Fix that bat should use system theme by @cannikin
- Fix screensaver shifting up between animations by @ryanrhughes
- Fix decryption screen logo being off-center on some monitors by @ryanrhughes
- Fix ristretto neovim compatibility with some plugins by @gthelding
- Fix that pressing any key should cancel the screensaver by @dhh
Update by running omarchy-update
or Go to Update > Omarchy in the Omarchy TUI.
Invitation to update

Faded numbers for empty workspaces

Icon theme colors
Here are all the available options: Yaru Yaru-blue Yaru-dark Yaru-magenta Yaru-olive Yaru-prussiangreen Yaru-purple Yaru-red Yaru-sage Yaru-wartybrown Yaru-yellow


New Contributors
- @sailoz made their first contribution in #393
- @Mohamedsayhii made their first contribution in #396
- @ardavis made their first contribution in #402
- @cannikin made their first contribution in #438
- @brink-lab made their first contribution in #444
Full Changelog: v1.8.0...v1.9.0
v1.8.0
What changed?
- Add font menu for easily changing terminal fonts via
omarchy-font-menu
and in Omarchy TUI by @dhh - Add more resilient migration strategy that tracks which migrations you've run by @ardavis
- Add
Themes > Update
to Omarchy TUI to refresh extra themes by @ryanrhughes - Add .bak.$timestamp strategy to the omarchy-refresh-* scripts to prevent ever losing configs by
- Add file finder to application launcher by using "." as a leader key by @Mohamedsayhii
- Add font packages ttf-cascadia-mono-nerd and ttf-ia-writer instead of manually downloading fonts by @dhh
- Add $OMARCHY_PATH as default env by @dhh
- Fix bug where application launcher wouldn't pickup fresh theme by @dhh
- Fix decryption screen logo to match the updated version by @tahayvr
Update by running omarchy-update
twice. That'll ensure that the new strategy for migrations is initialized, and any migrations you might have missed will be run. On your next update, you just run it once.
New font menu

New finder via application launcher

(Note that the finder might take a while on big searches)
Full Changelog: v1.7.0...v1.8.0
v1.7.0
What changed?
- Add new Omarchy screensaver on SUPER + ALT + SPACE by @dhh
- Add a beautiful brown ristretto theme by @gthelding
- Add ALT+TAB to cycle between windows, including floating ones, on the active workspace by @c4software
- Add Omarchy version to About app by @tahayvr
- Fix About should float and center
- Fix update logos to use the cleaned up version by @seanmitchell
- Fix default monitors.conf to include more examples by @dhh
- Fix default .bashrc to offer examples and explanation by @dhh
- Fix sorting of the theme menu picker by @dhh
- Fix restricting Steam centering to only the main window by @sobran
Update using omarchy-update all
.
New screensaver
screenrecording-2025-07-28_14-03-32.mp4
New ristretto theme

New Contributors
- @sobran made their first contribution in #380
- @gthelding made their first contribution in #384
Full Changelog: v1.6.2...v1.7.0
v1.6.2
What changed?
- Add updating timezone (using geo by IP) by right-clicking on the clock by @dhh
- Add color terminal text effects for the installer and break it into 5 distinct segments by @dhh
- Add a cleaned-up version of the Omarchy logo by @tahayvr and @seanmitchell
- Add Chaotic-AUR support for precompiled installations of dependencies like Pinta by @saullrb
- Add = as the leader key for calculations in app launcher (so type =5+5 to get 10) by @ryanrhughes
- Add options to override output from screenshot and screenrecord commands using
OMARCHY_SCREENRECORD_DIR
andOMARCHY_SCREENSHOT_DIR
by @benhoman - Add that bare installs are remembered by @JaxonWright
- Fix waybar stacking after sleep/locking by reloading waybar by @dhh
- Fix background would sometimes disappear after changing theme (because swaybg would exit) by @dhh
- Fix screenshot stacking if hitting hotkey twice by @ryanrhughes
- Fix mismatched colors for mako and swayosd for some themes by @dhh
- Fix using matte black neovim plugin instead of inline color coding by @tahayvr
- Fix respect XDG_DIRS for languages other than English for screenshot/screenrecord commands by @michaldziurowski
- Fix fzf completion path by @anagrius
The new installation effects:
omarchy-install.mp4
New Contributors
- @benhoman made their first contribution in #322
- @anagrius made their first contribution in #337
- @michaldziurowski made their first contribution in #342
- @JaxonWright made their first contribution in #351
- @seanmitchell made their first contribution in #361
Full Changelog: v1.6.1...v1.6.2