What changed?
Update existing installations using Update > Omarchy
from Omarchy menu (Super + Alt + Space
).
Install on new machines with the ISO:
- Download: https://iso.omarchy.org/omarchy-3.1.0.iso
- SHA256: 85b9790e7687ca9e8137c9d2b8c52643686c229cad1e1aae353c76ee8f6aba00
New keys and capabilities
- Add universal copy/paste on
Super + C / V
by @ryanrhughes - Add clipboard manager on
Super + Ctrl + V
by @dhh - Add
Super + F
for fullscreen (instead of F11),Super + T
to toggle tiling/floating, and move app hotkeys toSuper + Shift + [letter]
(exceptSuper + Return
stays for Terminal) as new defaults and opt-in for existing installs by @dhh - Add tiling groups hotkeys and styling by @reshadman
- Add screenrecording with webcam to new unified
Alt + PrtScrn
hotkey by @ryanrhughes - Add smart screenshot selection so region/window/display can be capture by
PrtScr
alone by @ryanrhughes - Add straight-to-clipboard screenshot capture on
Shift + PrtScr
by @dhh
New looks
- Add live theme changes to neovim by @ryanrhughes
- Add live theme changes to Obsidian by @darcy
- Add live theme changes to Cursor by @ludagoo
- Add live theme changes to helium browser by @CantC0unt
- Add Aether application for creating your own theme by @bjarneo
- Add Flexoki Light as new default theme by @euandeas
- Add extra background image for Matte Black theme by @vaqMAD
- Add more blur to the transparent windows (really helps on Kanagawa!) by @vyrx-dev
- Add Apple brightness adjustment display overlay by @miharekar
- Add Learn Keybindings notification that links to cheatsheet for new installations by @dhh
New infrastructure
- Add Install > Windows for easily setting up a Windows VM by @sspaeti + @ryanrhughes
- Add Walker 2.0 to prevent memory leak and speed up execution by @ryanrhughes + @abenz1267
- Add default keyring that unlocks on login through sddm by @ryanrhughes
- Add unified gpu screen recorder that works for nvidia and others by @ryanrhughes
- Add hooks system under
~/.config/omarchy/hooks
for theme set, font set, and post update by @dhh - Add explicit timezone selection to Update > Timezone instead of attempting to geoguess by @dhh
- Add
Update > Firmware
to runfwupdmgr update
with updated metadata and installing the command by @EFIR - Add
Install > AI > Cursor CLI
by @rajofearth - Add support for Thinkpad E14 Gen 6 fingerprint sensor by @aislandener
- Add mailto: handler for default HEY email client by @ryanrhughes
- Add vim keybindings to btop navigation by @martinmose
- Add guard against installing on systems with secure boot enabled by @killeik
- Add Trigger > Capture > Screencast > Display + Webcam to record screen with a webcam overlay in the corner by @ryanrhughes
- Add MSSQL to Install > Development > Docker DB > MSSQL by @johannesnormannjensen
- Add node by default to appease tree-sitter in latest lazyvim by @ryanrhughes
Fixed stuff
- Fix slow reboots/shutdowns by cutting timeout limit for services to 5 seconds by @ryanrhughes
- Fix polkit error after install by @ryanrhughes
- Fix overeager "application is not responding" timeout by setting it to ~5s instead of 2s by @dhh
- Fix manually rebooting or relaunching after omarchy-update flagged the need wouldn't clear it by @alexperreault
- Fix electron36/37 useless icons would show up in app launcher by @sgruendel
- Fix jconsole/jshell icons added for limine restore shouldn't show up in the app launcher by @dhh
- Fix "open in nvim" from file manager by @dharmavagabond
- Fix '(null)' display on AirPod source selection via audio switch by @shawnyeager
- Fix current working directory in cases where a real directory isn't returned by cwd by @matt-h
- Fix using uwsm-app instead of "uwsm app" to speedup launching apps by @woopstar
- Fix launching helix as editor by @Cammisuli
- Fix ASCII logo alignment being wrong in system terminal presentations when user had increased font size by @vaqMAD
- Fix omarchy-launch-or-focus-webapp would swallow extra parameters by @meirdick
- Fix screensaver wouldn't stop when locking screen by @vladkhard
- Fix shutdown/reboot should happen without terminal output being show by @mlombardi96
- Fix keybindings menu to be more humanly readable (no more code:10) by @ludagoo
- Fix slow performance on opening keybindings menu by using caching by @davidwinter
- Fix waybar would be started on theme set even if user had hidden (stopped) it by @celsobenedetti
- Fix theme switching should set light/dark mode live for chromium by @dhh
- Fix highlight color problem with theme switching using profiles by reverting to
--set-theme-color
for now by @dhh - Fix ssh session integration for Ghostty by @mirzap
- Fix ghostty tab design to look better integrated with rest of system design by @scossar + @Thundernirmal
- Fix text placement and fingerprint fail message reveal on lock screen by @mlombardi96
- Fix calculator sizing by making it float by default by @gkurts
- Fix MacBook issues with login keyboard and suspend/wake-up by @wey-gu
- Fix Tailscale split DNS compatibility by removing [!UNAVAIL=return] by @jardahrazdera
- Fix broken Apple Display brightness control keys by @dhh
- Fix Catpuccin theme to use proper Mocha colors by @qasimsk20
- Fix Chromium crash when moving windows between monitors by @d-cas
- Fix app launcher icons for X and GitHub to work with light mode by @nqst
- Fix make bcm43xx driver script vendor agnostic by @sa-dd
- Fix all three terminals should always partake in a theme switch regardless of which one is primary by @dhh
- Fix reference to everforest theme in ghostty config by @carljohanlandin
- Fix VSCode's own auto-update clashing with pacman by turning it off by @sgruendel
- Fix symlinked backgrounds should be included in background/theme rotation by @giovantenne
- Fix live theme setting for Brave by @CantC0unt
- Fix icon spacing in waybar for new setups by @brink-lab
Feature presentations
Universal copy/paste on Super + C / V
No more remembering that terminals need Shift + Ctrl + C / V
and all other apps use Ctrl + C / V
. Now you can use Super + C / V
as a unified shortcut for copy/paste. Super + X
is also mapped as cut, but note that this doesn't (and never did) work in the terminal.
This has required that we move app shortcuts to Super + Shift + [letter]
. So terminal now starts on Super + Shift + Return
, Calendar on Super + Shift + C
, etc.
This also means fullscreen is now Super + F
(instead of F11) and toggling a window between tiling/floating happens on Super + T
.
For existing installations, this is an optional change that you'll be prompted to opt-in to during migration. For new installations, this is the new default. As always, you can see your keybindings on Super + K
.
Clipboard manager on Super + Ctrl + V
Expose Walker's built-in clipboard manager on Super + Ctrl + V
.

Tiling groups
Tiling groups allows you to put any combination of windows into a tabbed group. You can move windows in and out of the group or remove the group entirely.
screenrecording-2025-10-14_12-43-23.mp4
Hotkeys:
# Toggle groups
bindd = SUPER, G, Toggle window grouping, togglegroup
bindd = SUPER ALT, G, Move active window out of group, moveoutofgroup
# Join groups
bindd = SUPER ALT, LEFT, Move window to group on left, moveintogroup, l
bindd = SUPER ALT, RIGHT, Move window to group on right, moveintogroup, r
bindd = SUPER ALT, UP, Move window to group on top, moveintogroup, u
bindd = SUPER ALT, DOWN, Move window to group on bottom, moveintogroup, d
# Navigate a single set of grouped windows
bindd = SUPER ALT, TAB, Next window in group, changegroupactive, f
bindd = SUPER ALT SHIFT, TAB, Previous window in group, changegroupactive, b
# Activate window in a group by number
bindd = SUPER ALT, 1, Switch to group window 1, changegroupactive, 1
bindd = SUPER ALT, 2, Switch to group window 2, changegroupactive, 2
bindd = SUPER ALT, 3, Switch to group window 3, changegroupactive, 3
bindd = SUPER ALT, 4, Switch to group window 4, changegroupactive, 4
bindd = SUPER ALT, 5, Switch to group window 5, changegroupactive, 5
Note: These hotkeys are only available if you opt-in to the new Omarchy hotkeys brought on by the universal copy/paste change. This is due to the use of Super + G
(which would otherwise conflict with the old Signal hotkey). If you don't opt-in, you can just copy these bindings to your own ~/.config/hypr/bindings.conf
file and set them as you please.
Smart screenshot selection
We've replaced the three different screenshot keybindings with a single smart version that selects windows when you hover over them, the whole screen on hover on the top bar, and custom region if you drag. This is now all available on PrtScr
. This has made room for Shift + PrtScr
to use the same smart selection, but then send the result straight to the clipboard without going through Slurp for editing first.
Live theme changes for neovim
The built-in themes now have live changes out of the box. For extra themes, you'll still need to restart neovim after first installing/selecting it.
screenrecording-2025-10-14_12-39-19.mp4
Live theme changes for Obsidian
Select the Omarchy
theme under Appearance > Themes in Obsidian, and you'll get live theme changes.

Live theme changes for Cursor
Just like VSCode, we now have live theming for Cursor. It's not supported by all themes, though. Of the built-in, you'll get Catppuccin, Catppuccin Latte, Everforest, Gruvbox, Nord, Ristretto, Rose Pine, Tokyo Night. The others are not supported.

Aether theme editor
Create your own Omarchy theme with @bjarneo's excellent Aether app. You can base your theme on an existing set, find the right wallpaper, and instantly apply it or export to share.

Flexoki Light Theme


Windows VM
Running a Windows VM inside of Omarchy gives you an easy way out of running those few, rare applications that simply must be native, and aren't available on Linux. With Install > Windows, you'll end up with a Docker-based Windows VM. Note: There's no GPU pass-through (yet?), so it's not meant for gaming.
