Omarchy Guide

Learn Omarchy from installation planning through shortcuts, themes, updates, and troubleshooting on Arch Linux and Hyprland.

Omarchy combines Arch Linux, Hyprland, and an opinionated desktop configuration. This guide is for people new to tiling window managers and for Windows or macOS users who want a practical route into a keyboard-driven Linux workflow.

Independent guide

This is not the official Omarchy website. Use the official Omarchy manual for authoritative releases, downloads, and security notices.

Recommended path

Decide whether it fits

Understand Omarchy, Arch Linux, Hyprland, and the keyboard-first model.

Install safely

Plan backups, create media, and verify the first boot.

Move from Windows or macOS

Map familiar actions to Omarchy.

Learn essential shortcuts

Windows, workspaces, launching, and screenshots.

Complete topic map

Omarchy Quattro 4.0

New shell, plugin architecture, ISO, and upgrade checks.

Omarchy Plugins

Installation, updates, permissions, and recovery.

Virtual machine install

VirtualBox, VMware, Parallels, and the Windows VM.

Omarchy, CachyOS, and Ubuntu

Compare desktop, updates, and real workloads.

Your first day

Top bar, panels, clipboard, and post-install checks.

Input methods and fonts

Fcitx5, Rime, complex input, and CJK fonts.

Apps and development

Packages, AUR, mise, Docker, and toolchains.

Community tools

Real projects, repositories, licenses, verification status, and original posts.

AI Agents

Claude Code, Codex, a default agent, and local models.

System configuration

Displays, HiDPI, network, Bluetooth, and audio.

Snapshots and recovery

Limine rollback, config restore, and safe cleanup.

Advanced customization

Hyprland, the bar, keybindings, and themes.

CLI reference

Current commands, group help, and automation boundaries.

How this guide is maintained

Each page answers one search intent, carries an update date, and separates risky system changes from everyday workflow advice. Before partitioning, encryption, dual boot, or updates, create a verified backup and recovery media.

What you will learn

Which devices and work habits suit Omarchy;
how to prepare an installation without casually erasing data;
how Command, Option, the Windows key, and virtual desktops map to Super and workspaces;
where to verify shortcuts, themes, and commands for your installed version;
how to configure complex input, displays, networks, audio, apps, and development tools;
how to use AI agents, snapshots, and advanced installation modes safely;
how to troubleshoot by preserving evidence, narrowing scope, and changing one thing at a time.

If you have a test machine ready, begin with the installation guide. If you are still evaluating the system, start with What is Omarchy?.