Sources and licensing
These docs are written here
Everything on these pages was written for this gallery and verified against a real Omarchy install running 4.0.0.alpha on September 15, 2026 — the theme scripts in $OMARCHY_PATH/bin/, the bundled themes, the templates in default/themed/, and the technical theming documentation in Omarchy’s source repository.
Omarchy is an independent project, and this gallery is not affiliated with it. Where upstream is the better answer — install instructions, hardware notes, anything outside theming — we link there rather than paraphrase.
Why the manual is not mirrored here
Omarchy’s code and its website are licensed differently, and it matters here.
- omacom/omarchy , the source, is MIT-licensed. Its
docs/theming.mdmay be reused with attribution, and it informed the reference pages here. - omacom/omarchy-site , which contains the manual, carries no licence file, and omarchy.org’s footer reserves all rights.
So the manual is not reproduced on this site. Its prose is nobody’s to copy without permission, and a paraphrase that tracked it sentence by sentence would be the same thing with extra steps. What is here instead is an independent description of behaviour we verified ourselves, organised for people making a theme, with links to the manual for everything else.
Read upstream
The chapters of Omarchy’s official manual that bear on theming:
- Making your own theme — upstream’s own guide.
- Themes — switching, installing and managing themes as a user.
- Backgrounds — how wallpapers behave on the desktop.
- Shell plugins — the plugin system in depth.
- The top bar — bar layout and widget placement.
- Branding and common tweaks — the customisation around a theme.
- Omarchy CLI — every
omarchysubcommand. - docs/theming.md — the MIT-licensed technical reference in the source repository.
- Extra themes and plugins.omarchy.org — the official listings.
Omarchy changes quickly. If something here disagrees with your machine, your machine is right — and we would like to know.