Update existing installations using Update > Omarchy from Omarchy menu (Super + Alt + Space).
Install on new machines with the ISO:
omarchy CLI by @ryanrhughesSuper + Ctrl + PrtScr using tereseract OCR by @Prajwal-PrathikshSuper + Ctrl + Alt + Del by @timbelmonSuper + Shift + Alt + M by @bjarneoic (= tdl c), ix (= tdl cx), and icx (= tdl c cx) by @dhhfsck.fat and mkfs.fat available in case you need to fix a corrupted /boot partition by @niralettertranscode-video-gif function for turning a video into a gif by @dhhfred=on kernel optimization for Intel Panther Lake systems by @dhhSDL_VIDEODRIVER env causing problems with many Steam games by @RyanBreakeromarchy plymouth) by @dhhSuper + Ctrl + O) (limine can then be selected as a boot option in bios if needed) by @dhhSuper + Ctrl + O) by @dhhSuper + Ctrl + H) by @niraletterSuper + Ctrl + H) by @niraletterShift + Brightness Up and minimum brightness on Shift + Brightness Down by @dhhSuper + / in the default monitors.conf is used with just a single declared monitor by @dhhF5 by @ryanrhugheshyprpicker alive until the capture is complete by @ryanrhugheslstopo.desktop entry in the app launcher by hiding it by @dhhThere's now a single omarchy command that is both documented and bash tab-completing. It gives you access to all the underlying omarchy-* commands without having to look up the source to learn what they do.
~ ❯ omarchy
Omarchy command center
Usage:
omarchy <command> [args...]
omarchy commands [--all] [--json] [--check]
omarchy <group> --help
omarchy <group> <command> --help
Common commands:
omarchy update Update Omarchy and system packages
omarchy theme list List available themes
omarchy theme set <name> Apply a theme
omarchy font list List available fonts
omarchy screenshot Take a screenshot
omarchy debug Print debugging information
Groups:
ac AC power detection
battery Battery status helpers
branch Omarchy git branch management
brightness Display and keyboard brightness
capture Screenshots and screen recording
channel Omarchy release channel management
cmd Command and shortcut helpers
config System configuration helpers
debug Diagnostics and support logs
dev Omarchy development tools
drive Drive selection and encryption
font Font management
hibernation Hibernation setup and removal
hook User hook runner
hw Hardware detection and controls
hyprland Hyprland window, monitor, and toggle controls
install Optional software installers
launch Application launchers
menu Omarchy menu commands
migrate Migration runner
notification Notification helpers
npx NPX package wrappers
pkg Package management helpers
plymouth Plymouth boot theme management
powerprofiles Power profile management
refresh Reset config to defaults
reinstall Reinstall and reset workflows
remove Removal workflows
restart Restart Omarchy components
setup Interactive setup wizards
share Share clipboard, files, and folders
snapshot System snapshots
state Persistent Omarchy state
sudo Sudo configuration helpers
swayosd SwayOSD status display helpers
system Reboot, shutdown, logout, and lock
theme Theme management
toggle Toggle Omarchy features
tui Terminal UI launchers
tz Timezone selection
update Omarchy and system updates
upload Upload helpers
version Version and channel information
voxtype Voxtype dictation
webapp Web app launchers
wifi Wi-Fi helpers
windows Windows VM management
Discovery:
omarchy commands List all commands
omarchy commands --all Include commands explicitly marked hidden
omarchy commands --json Machine-readable command list
omarchy commands --check Validate command metadata and routesTesseract's open source OCR model makes it super quick to grab text out of any part of the screen. This is very helpful for grabbing addresses out of image footers or phone numbers embedded in website headlines. You can trigger it directly using Super + Ctrl + PrtScr or via the capture menu (Trigger > Capture or Super + Ctrl + C). The extracted text ends up on the clipboard ready for pasting.
Gaming on Omarchy just got a huge overhaul. First, the Steam installer is now fully automated (no more picking gpu libs!) and more compatible due to removal of the troublesome SDL_VIDEODRIVER env variable (reboot after upgrading to get rid of it!). Great way to play everything from Tetris Effects to ARC Raiders.
The RetroArch installer has gotten an even bigger upgrade by removing the AUR dependency (making it much faster to install) and preconfiguring the system, so all you have to do is put your bios and rom files in ~/Games, scan the directory, and you're ready to game using the beautiful CRT Royale shader for that perfect retro look.
You can now run Battle.net games via the Lutris launcher too! Remember Starcraft? Remember Diablo? WE REMEMBER!. It's a little janky to install, though. You just have to follow the instructions and be patient while it looks like nothing is happening, but it's working in the background.
There's also the Heroic Launcher, which allows you to run Epic Games titles, like OddSparks, without anti-cheat (so, sadly, no Fortnite or Rocket League!). It too is a little janky and slow to install games, but until Tim Sweeney comes to Linux, it's better than nothing!
The Xbox Cloud Gaming setup is "just" a web app for the service, but it works great, and it starts really quick. Good 1080p gaming if you already have Xbox Game Pass. Access to games like Fortnite and other titles you can't run natively anyway!
Finally, there's the Moonlight client for streaming games off a Windows PC running Sunshine. If you can hardwire both your Omarchy machine and the remote gaming PC, it's indistinguishable from running the games locally! Just crank up the resolution to full native, set it to 120hz, and max out the bitrate, and you'll have the best way to play competitive shooters like Fortnite on Linux.
Every theme can now include preview-unlock.png and unlock.png (transparent) to be listed under Style > Unlock, so they appear as options for a custom boot unlock design. You can also manually design your new unlock screen using omarchy-plymouth-preview and omarchy-plymouth-set — great for company logos!
Direct boot (to skip limine preboot rollback screen) and temporary passwordless sudo (for letting agents change the system) has been added to the Trigger > Toggle menu. You can access it directly with Super + Ctrl + O.
Mirroring your laptop screen for a projector can now be done from the hardware toggle menu under Trigger > Hardware or by hitting Ctrl + Super + Alt + Delete.
When Helix is installed via Install > Editor > Helix, it'll be included in the automatic Omarchy themeing.
Cliamp is a beautiful TUI by Aether creator @bjarneo. It comes with three great radio stations for computer lovers out of the box, Lofi, Synthwave, and EDM. You can connect your Spotify account to it as well. Along with YouTube Music and other sources.
You can start it from the app launcher with Super + Space or directly with Super + Shift + Alt + M.
ghui is a new TUI for managing your GitHub pull requests. It's installed on-demand with the first invocation of ghui on the terminal.
As part of the unified Omarchy CLI, several omarchy-* scripts were renamed to fit the new namespacing. If you have personal scripts, hotkey bindings, or Waybar/Hypr configs calling the old names directly, update them to the new ones below. Configs shipped by Omarchy itself are migrated automatically.
| Old name | New name |
|---|---|
omarchy-cmd-audio-switch |
omarchy-audio-output-switch |
omarchy-cmd-mic-mute |
omarchy-audio-input-mute |
omarchy-cmd-screenrecord |
omarchy-capture-screenrecording |
omarchy-cmd-screenshot |
omarchy-capture-screenshot |
omarchy-cmd-first-run |
omarchy-first-run |
omarchy-cmd-screensaver |
omarchy-screensaver |
omarchy-cmd-share |
omarchy-menu-share |
omarchy-lock-screen |
omarchy-system-lock |
omarchy-sudo-passwordless-toggle |
omarchy-sudo-passwordless |
The Dell XPS and ThinkPad mic-mute variants (omarchy-cmd-mic-mute-xps, omarchy-cmd-mic-mute-thinkpad) have been folded into the single omarchy-audio-input-mute, which now handles hardware LED syncing internally.
You can also reach all of these through the new unified CLI, e.g. omarchy capture screenshot, omarchy audio input mute, or omarchy system lock.
Full Changelog: v3.6.0...v3.7.0