# Omarchy

> The keyboard-first Linux desktop, for people arriving from Windows, macOS, or Ubuntu - tiling windows, menus, and hotkeys until it feels like home, then making it yours, plugins, and fixing it when it breaks.

12 guides.

- [What Omarchy Actually Is](https://themissingmanual.dev/guides/what-omarchy-actually-is) _(beginner)_ - What Omarchy really is (Arch Linux plus Hyprland plus Quickshell, assembled by someone with taste), how it differs from Windows, macOS, and Ubuntu, who it suits and who it does not, and how to try it without risking your current computer.
- [Installing Omarchy](https://themissingmanual.dev/guides/installing-omarchy) _(beginner)_ - Install Omarchy from a USB stick without losing anything you care about: back up, set the firmware switches the manual requires, verify the ISO, answer the installer, dual boot if you want to keep Windows, and finish with a first-boot checklist.
- [Omarchy for Windows, macOS, and Ubuntu Users](https://themissingmanual.dev/guides/omarchy-for-windows-macos-and-ubuntu-users) _(beginner)_ - A where-did-X-go map for people arriving on Omarchy from Windows, macOS, or Ubuntu: the Super key, the Omarchy menu, translation tables for every habit you brought with you, the ten hotkeys to learn on day one, and drills that retrain the reflexes that will fight you.
- [Omarchy Tiling Windows and Workspaces](https://themissingmanual.dev/guides/omarchy-tiling-windows-and-workspaces) _(beginner)_ - How tiling works on Omarchy: windows that share the screen instead of overlapping, the dwindle and scrolling layouts, focusing, moving, swapping and resizing windows from the keyboard, floating and fullscreen modes, workspaces, the scratchpad, and multiple monitors.
- [Omarchy Menus, Panels, and the CLI](https://themissingmanual.dev/guides/omarchy-menus-panels-and-cli) _(beginner)_ - Learn the three control surfaces of Omarchy 4: the Super + Space menu, the top bar with its panels and toggles, and the omarchy command in the terminal, so you can find and change anything without hunting through settings windows.
- [Installing and Updating Software on Omarchy](https://themissingmanual.dev/guides/installing-and-updating-software-on-omarchy) _(intermediate)_ - Learn how software reaches an Omarchy machine through pacman, the Omarchy repository, the AUR, web apps, and TUIs, how omarchy update keeps a rolling release safe with snapshots, and how to judge an AUR package by reading its PKGBUILD.
- [Making Omarchy Comfortable](https://themissingmanual.dev/guides/making-omarchy-comfortable) _(intermediate)_ - Learn where Omarchy keeps your settings and how updates treat them, then change keybindings in Lua, tune keyboard, trackpad and monitor scaling, and restyle themes, fonts, and the bar without breaking anything.
- [The Omarchy Terminal Workflow](https://themissingmanual.dev/guides/the-omarchy-terminal-workflow) _(intermediate)_ - Learn the terminal setup Omarchy ships - Foot, the shell tools, tmux, Neovim, the TUIs, and the dev tools - so you can work from the keyboard with sessions that survive closing the window.
- [Omarchy Plugins and the Marketplace](https://themissingmanual.dev/guides/omarchy-plugins-and-the-marketplace) _(intermediate)_ - What an Omarchy plugin really is, why it runs with all your access, how to judge one before you install it, the real omarchy plugin commands, and a worked install of The Missing Manual plugin.
- [The Missing Manual on Omarchy](https://themissingmanual.dev/guides/the-missing-manual-on-omarchy) _(beginner)_ - Install The Missing Manual's own Omarchy plugin and read the whole library from your keyboard-first desktop: a reader window themed to your desktop, live search, quizzes, diagrams, an optional bring-your-own-key study chat, and a matching terminal client.
- [Building Your Own Omarchy Plugin](https://themissingmanual.dev/guides/building-your-own-omarchy-plugin) _(advanced)_ - Build, test, and publish an Omarchy plugin: manifest and layout, the clone-edit-validate loop, wiring into the bar, menu, keybindings and theme, the safety rules, and listing it on the marketplace.
- [When Omarchy Breaks](https://themissingmanual.dev/guides/when-omarchy-breaks) _(advanced)_ - A calm repair kit for Omarchy: a symptom-to-fix cheat card, rolling back with system snapshots, reading logs, rescuing a desktop that will not start, fixing Wi-Fi, sound, sleep and display problems, getting help well, and reinstalling without losing your files.