Omarchy 3.1.0

[dhh]

What changed?

Update existing installations using Update > Omarchy. Install on new machines with the ISO.

Note: Unreleased.

New keys and capabilities

• Add universal copy/paste on Super + C / V by @ryanrhughes
• Add clipboard manager on Super + Ctrl + V by @dhh
• Add tiling groups hotkeys and styling by @reshadman

New looks

• Add live theme changes to neovim for built-in themes by @ryanrhughes
• Add live theming for Cursor by @ludagoo
• Add Flexoki Light as new default theme by @euandeas
• Add extra background image for Matte Black theme by @vaqMAD
• Add Apple brightness adjustment display overlay by @miharekar

New infrastructure

• 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 Update > Firmware to run fwupdmgr 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

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

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.

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.

Live neovim theme changes

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 theming 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.

Flexoki Light Theme

[miharekar]

Docs are not open source so there's no way to open a PR, but keyboard layouts switching instructions should be updated here: https://learn.omacom.io/2/the-omarchy-manual/78/keyboard-mouse-trackpad

[Because789]

I just updated from the dev branch and accepted the new shortcuts. Now the app launcher is messed up, selecting an app with enter doesn't work anymore, I have to press shift + enter to open an app from the launcher.

[abenz1267]

I just updated from the dev branch and accepted the new shortcuts. Now the app launcher is messed up, selecting an app with enter doesn't work anymore, I have to press shift + enter to open an app from the launcher.

outdated version.

[jvanbaarsen]

I just updated, and it fully bricked my system: #2469 Resolved

[Tharun-tharun]

I don’t see the updated 3.1.0 tag yet it’s not listed under releases, only visible in the pull request. Should we wait until it’s confirmed and merged into the master branch before updating the omarchy

edit: oh i just noticed it’s still unreleased. my bad, I assumed it had already moved past testing, anyway will keep eye on the new full update release. thanks!