omarchy README

The project's README from github.com/omacom/omarchy. As one markdown file: README.md.

Omarchy

Omarchy is a beautiful, fun & agentic Linux distribution by DHH.

Read more at omarchy.org.

The Omarchy Manual

The manual lives in manual/, which is its authoritative source. It's mirrored to learn.omacom.io, where its screenshots are also hosted.

The Basics

The Applications

Configuration

The Rest

License

Omarchy is released under the MIT License.

omarchy (omacom/omarchy)

Searching Database…

What is this?Omarchy is an opinionated, pre-configured Linux desktop setup created by DHH, built on Arch Linux and the Hyprland window manager, bundling curated apps, themes, and keybindings for a polished out-of-the-box experience.
Is this a full Linux distro or just a dotfiles config?It installs as a configuration layer on top of Arch Linux with Hyprland, covering the terminal, Neovim, shell tools, TUIs, GUIs, browsers and more rather than being a single app.
Do I need Arch Linux and Hyprland already set up?Yes, Omarchy is built around an Arch Linux base with Hyprland as the Wayland compositor, so it assumes that foundation rather than working on an arbitrary distro.
Will it work if I'm coming from Mac or Windows?The manual has a dedicated 'Coming From Mac or Windows' guide plus a separate Mac support page, suggesting some rough edges or differences for users migrating from those systems.
Who is this aimed at?It's aimed at developers and power users who want a ready-made, stylish Linux desktop without manually configuring Arch and Hyprland themselves.
What apps and tools come preinstalled?The manual lists a curated set including a terminal, Neovim, AI tools, development and shell tools, TUIs, GUIs, browsers, commercial apps/services, web apps, and even gaming support.
Who is DHH and why did he build this?DHH is David Heinemeier Hansson, creator of Ruby on Rails; Omarchy reflects his personal opinionated Linux desktop setup made public for others to use.
Can I customize the look with my own theme?Yes, the manual includes sections on Themes, Backgrounds, Fonts, Branding, and a guide for 'Making your own theme'.
Does it handle things like clipboard history and screenshots?Yes, it ships with Unified Clipboard & History, Screenshots & Recording, and Text Extraction & Dictation features documented in the manual.
Creator
omacom
Size
1.2 GB
Stars
45K
Age
1y
Commits · 90 Days