The Omarchy Way: How to Customize Omarchy Linux: Arch, Hyprland, Quickshell, and First-Class Agents (The Omarchy Books)

Your look-and-feel file has fifty lines in it and forty-five of them are commented out. That is not a configuration. It's a menu. You like this machine. You stopped thinking about window placement weeks ago. And there are two or three things you would change tonight if you were sure the change survived Tuesday's update. So you close the file.

That is not a Lua problem, and getting better at Lua does not touch it. It is a durability problem, and the layer nobody has written down: where the line falls between what the distribution owns and what you own. Every recipe here names the result the shipped script says you get, then the lever that puts it back, printed before the change and not after.

What you will have:

Six changes made in your first hour, each with its way back written down first Hyprland rebound in Lua by two lines, in a file the next update will not overwrite A theme you authored, a bar you arranged, and a Quickshell widget you wrote A keep list: the files worth putting under version control, and why the rest are not A coding agent wired in as a desktop citizen: the permission flag it launched with, the skill file it reads, the crash it diagnoses, and the short list of things no lever here undoes One evening, three hours, only recipes already printed, that ends with a machine that looks like you Written against Omarchy 4.0.1 Quattro as of August 2026. Version 4 replaced the shell and converted every Hyprland config to Lua. It is a rolling distribution, so the book is dated on its front page: when it and your machine disagree, your machine is right.

For you if you already run this desktop and would rather understand a machine than memorize it. The Ultimate Omarchy Linux Book is the companion for the install and the full hotkey tables. This one starts at the first config file.