Omarchy Cheat Sheet for Devs

A comprehensive reference for Omarchy - an opinionated Arch Linux + Hyprland setup by DHH.

Essential Keyboard Shortcuts

System & Window Management

Shortcut	Function
`Super + K`	Show all hotkeys
`Super + Space`	Application launcher
`Super + Alt + Space`	Omarchy control menu
`Super + Escape`	Lock/suspend/relaunch/restart/shutdown
`Super + W`	Close window
`Ctrl + Alt + Del`	Close all windows
`Super + T`	Toggle window between tiling/floating
`Super + O`	Toggle popping window into sticky & floating

Workspace Navigation

Shortcut	Function
`Super + 1/2/3/4`	Jump to specific workspace
`Super + Alt + Tab`	Jump to next workspace
`Super + Alt + Shift + Tab`	Jump to previous workspace
`Super + Ctrl + Tab`	Jump to former workspace
`Shift + Super + 1/2/3/4`	Move window to workspace
`Super + Alt + S`	Move window to scratchpad workspace

Window Control

Shortcut	Function
`F11`	Go full screen
`Shift + F11`	Force full screen (e.g., Spotify)
`Alt + F11`	Go full width for the window
`Super + Arrow`	Move focus to window in direction
`Super + Shift + Arrow`	Swap window with another in direction
`Super + Equal`	Grow windows to the left
`Super + Minus`	Grow windows to the right
`Super + Shift + Equal`	Grow windows to the bottom
`Super + Shift + Minus`	Grow windows to the top

Application Launching

Shortcut	Function
`Super + Return`	Terminal
`Super + Shift + B`	Browser
`Super + Shift + Alt + B`	Browser (private/incognito)
`Super + Shift + F`	File manager
`Super + Shift + T`	Activity monitor (btop)
`Super + M`	Music (Spotify)
`Super + /`	Password manager (1Password)
`Super + N`	Neovim
`Super + C`	Calendar (HEY)
`Super + E`	Email (HEY)
`Super + A`	AI (ChatGPT)
`Super + G`	Messenger (Signal)
`Super + Shift + G`	Messenger (WhatsApp)
`Super + Alt + G`	Messenger (Google)
`Super + D`	Docker (LazyDocker)
`Super + X`	X
`Ctrl + Super + S`	Share menu (via LocalSend)

Universal Clipboard

Shortcut	Function
`Super + C`	Copy
`Super + X`	Cut (not in terminal)
`Super + V`	Paste
`Super + Ctrl + V`	Clipboard manager

Screenshots & Screen Recording

Shortcut	Function
`Print Screen`	Screenshot a region
`Shift + Print Screen`	Screenshot a window
`Ctrl + Print Screen`	Screenshot a monitor
`Alt + Print Screen`	Screenrecord a region
`Ctrl + Alt + Print Screen`	Screenrecord a monitor
`Super + Print Screen`	Color picker
`Alt + Shift + L`	Copy current URL from webapp/Chromium

Notifications

Shortcut	Function
`Super + ,`	Dismiss latest notification
`Shift + Super + ,`	Dismiss all notifications
`Ctrl + Super + ,`	Toggle silencing notifications

Appearance & Theming

Shortcut	Function
`Ctrl + Shift + Super + Space`	Pick a new theme
`Ctrl + Super + Space`	Next background image
`Super + Backspace`	Toggle transparency on a window

System Toggles

Shortcut	Function
`Ctrl + Super + I`	Toggle idle/sleep prevention
`Ctrl + Super + N`	Toggle nightlight display temperature
`Shift + Super + Space`	Toggle the top bar
`Super + Mute`	Switch to next audio output

File Manager (Specific)

Shortcut	Function
`Ctrl + L`	Go to path
`Space`	Preview file (arrows navigate)
`Backspace`	Go back one folder

Brightness Control

Shortcut	Function
`Ctrl + F1`	Turn down brightness
`Ctrl + F2`	Turn up brightness
`Ctrl + Shift + F2`	Turn up brightness to maximum

Neovim Shortcuts (with LazyVim)

Navigation

Shortcut	Function
`Space`	Show command options
`Space Space`	Open file via fuzzy search
`Space E`	Toggle sidebar
`Space G G`	Show git controls
`Space S G`	Search file content
`Ctrl + W W`	Jump between sidebar and editor
`Ctrl + Left/Right`	Change size of sidebar
`Shift + H`	Go to left file tab
`Shift + L`	Go to right file tab
`Space B D`	Close file tab

File Management

Shortcut	Function
`A`	Add new file in parent dir
`Shift + A`	Add new subdir in parent dir
`D`	Delete highlighted file/dir
`M`	Move highlighted file/dir
`R`	Rename highlighted file/dir
`?`	Show help for all commands

Emoji Picker

Shortcut	Emoji	Clue
`CapsLock M S`	😄	smile
`CapsLock M C`	😂	cry
`CapsLock M L`	😍	love
`CapsLock M V`	✌️	victory
`CapsLock M H`	❤️	heart
`CapsLock M Y`	👍	yes
`CapsLock M N`	👎	no
`CapsLock M K`	😘	kiss
`CapsLock M P`	🙏	pray
`CapsLock M M`	💰	money

For full emoji picker: Super + Ctrl + E

System Configuration

WiFi Setup

Using nmcli (NetworkManager):

# Enable WiFi
nmcli radio wifi on

# List available networks
nmcli device wifi list

# Connect to a network
nmcli device wifi connect "SSID_NAME" password "PASSWORD"

# Set auto-connect priority
nmcli connection modify "SSID_NAME" autoconnect-priority 10

# Check connection status
nmcli general status

# Show active connections
nmcli connection show --active

Using iwctl (during installation):

# Start iwctl
iwctl

# Scan for networks
station wlan0 scan

# List networks
station wlan0 get-networks

# Connect to network
station wlan0 connect NETWORK_NAME

Fingerprint Reader Setup

Via Omarchy Menu (Recommended):

Press Super + Alt + Space to open Omarchy menu
Navigate to: Setup > Security > Fingerprint
Follow the prompts to enroll your fingerprint

Manual Setup:

# Install fingerprint packages
sudo pacman -S fprintd

# Enroll fingerprint (right index finger)
fprintd-enroll

# Enroll all fingers
fprintd-delete "$USER"
for finger in {left,right}-{thumb,{index,middle,ring,little}-finger}; do
  fprintd-enroll -f "$finger" "$USER"
done

# Verify enrollment
fprintd-verify

Cancel fingerprint prompt: Press Ctrl + C during fingerprint authentication to use password instead.

Remove fingerprint:

Via Omarchy menu: Remove > Fingerprint
Or: fprintd-delete "$USER"

Hyprland Configuration

Config file locations:

~/.config/hypr/hyprland.conf      # Main Hyprland config (keybindings, apps, etc.)
~/.config/hypr/bindings.conf      # Custom keybindings
~/.config/hypr/monitors.conf      # Monitor configuration

Edit configs via Omarchy menu:

Press Super + Alt + Space
Navigate to: Setup > Configs > [process]
Edit in Neovim (:wq to save and restart process)

Reload Hyprland config: Changes are typically applied automatically when saved through Omarchy menu.

### Package Management with Pacman

Basic Commands:

# Update system
sudo pacman -Syu

# Install package
sudo pacman -S package_name

# Remove package
sudo pacman -R package_name

# Remove package with dependencies
sudo pacman -Rs package_name

# Search for packages
pacman -Ss keyword

# List installed packages
pacman -Q

# Show package info
pacman -Si package_name

# Clean package cache
sudo pacman -Sc

# List orphaned packages
pacman -Qdt

# Remove orphaned packages
sudo pacman -Rns $(pacman -Qdtq)

Important flags:

-S = Sync/install
-R = Remove
-Q = Query
-s = Search
-y = Refresh database
-u = Upgrade
-i = Info

AUR (Arch User Repository) with Yay

Install Yay:

sudo pacman -S --needed git base-devel
git clone https://aur.archlinux.org/yay.git
cd yay
makepkg -si

Yay Commands:

# Update everything (repos + AUR)
yay -Syu

# Search packages (repos + AUR)
yay -Ss package_name

# Install AUR package
yay -S aur_package_name

# Remove AUR package
yay -R aur_package_name

# Update only AUR packages
yay -Sua

Note: Yay is a wrapper around pacman and handles both official repos and AUR packages. Run yay as unprivileged user (it will prompt for password when needed).

Network Management

Enable NetworkManager:

sudo systemctl enable --now NetworkManager.service

Check network status:

# Show all network devices
nmcli device

# Show connection details
nmcli connection show

# Show IP address
ip addr

Important Configuration Files & Directories

Omarchy-specific

~/.config/                        # User config files (YOUR FILES)
~/.local/share/omarchy/           # Omarchy system files (don't edit directly)
~/.config/omarchy/current/backgrounds/  # Custom backgrounds
~/.bashrc                         # Custom aliases, functions, exports
~/.XCompose                       # Custom emoji shortcuts

System Files

/etc/NetworkManager/              # NetworkManager config
/etc/pacman.conf                  # Pacman configuration
/var/log/pacman.log              # Pacman log file
/var/lib/fprint/                 # Fingerprint data

Omarchy Menu Commands

Access via Super + Alt + Space:

Setup:

Setup > Security > Fingerprint - Configure fingerprint reader
Setup > Security > Fido2 - Configure Fido2 device
Setup > Configs > [process] - Edit configuration files
Setup > Install > Background - Install background images

System:

Update - Update Omarchy system
Capture - Screenshot/recording options
Install - Install additional software
Remove - Remove components

Tips & Tricks

Custom Keybindings

Edit ~/.config/hypr/bindings.conf to add or change keybindings.

Restart Components

# Restart Hyprland
Super + Escape > Relaunch

# Restart XCompose (after editing emoji shortcuts)
omarchy-restart-xcompose

Theme Management

Extra background images go in: ~/.config/omarchy/current/backgrounds/

Access theme picker: Ctrl + Shift + Super + Space

Browser Tab Navigation

Use Ctrl + 1/2/3/... to jump to specific browser tabs (works in most browsers).

Multiple Keyboard Layouts

Edit ~/.config/hypr/hyprland.conf:

input {
  kb_layout = us,fr
  kb_options = compose:caps,grp:alts_toggle
}

Switch layouts: Left Alt + Right Alt

File Management Best Practices

User configs: ~/.config/
Custom scripts: ~/.local/bin/
Don't edit: ~/.local/share/omarchy/ (overwritten on updates)
Override defaults in ~/.config/ instead of modifying Omarchy system files

Installation & Updates

Initial Installation:

wget -qO- https://omarchy.org/install | bash

Update Omarchy:

Via Omarchy menu: Super + Alt + Space > Update

Prerequisites:

Fresh Arch Linux installation
Disk encryption enabled (recommended)
wget installed during Arch setup
No desktop environment installed (Omarchy provides it)

Troubleshooting

WiFi Issues

# Check NetworkManager status
systemctl status NetworkManager

# Restart NetworkManager
sudo systemctl restart NetworkManager

# Check for WiFi device
nmcli device

Fingerprint Reader Not Working

# Check device recognition
lsusb | grep -i fingerprint

# Restart fprintd service
sudo systemctl restart fprintd.service

# Check service status
sudo systemctl status fprintd.service

Display Issues

Check monitor configuration: ~/.config/hypr/monitors.conf

Package Issues

# Refresh package database
sudo pacman -Syy

# Fix broken dependencies
sudo pacman -Syu

# Clear package cache
sudo pacman -Sc

Quick Reference Links

Omarchy Manual: https://learn.omacom.io
Omarchy Website: https://omarchy.org
Hyprland Wiki: https://wiki.hyprland.org
Arch Wiki: https://wiki.archlinux.org
AUR: https://aur.archlinux.org

Note: This cheat sheet covers Omarchy 3.x. Some shortcuts and features may vary between versions. Press Super + K anytime to see the full current hotkey list.

Proudly created and maintained by @iagooar - check out my latest project: qqqa is a lightweight, open-source LLM-powered assistant right in your terminal.

iagooar/omarchy_cheat_sheet.md