omacom /omarchy

Beautiful, Modern & Opinionated Linux

★ 46,699⑂ 6,012👁 215⑃ 9,432● 6,204▤ 72◈ 2,479
ShellMITCreated 2025-06-01omarchy.org
46,699
stars
+68
6,012
forks
215
watchers
9,432
prs
6,204
issues
72
releases
2,479
discussions

README

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.

- Welcome to Omarchy!

The Basics

- Getting Started
- Coming From Mac or Windows
- Navigation
- The top bar
- Themes
- Hotkeys
- Unified Clipboard & History
- Reminders
- Notices
- Text Extraction & Dictation
- Screenshots & Recording
- Toggles, idle & screensaver
- Omarchy CLI

The Applications

- Terminal
- Neovim
- AI
- Development Tools
- Shell Tools
- Shell Functions
- TUIs
- GUIs
- Browsers
- Commercial apps/services
- Web Apps
- Gaming
- Filling out PDFs
- Windows VM
- Other Packages

Configuration

- Updates
- Dotfiles
- Shell plugins
- Monitors
- Keyboard, Mouse, Trackpad
- Networking
- System sleep
- Hardware authentication
- Fonts
- Backgrounds
- Prompt
- Branding
- Common tweaks
- Making your own theme

The Rest

- Mac support
- Troubleshooting
- FAQ
- System snapshots
- Security
- Omarchy on...
- Dual Boot Install
- Unattended Installs

 License

Omarchy is released under the MIT License.

Top issues

Discussions

Latest release

v4.5.0 v4.5.0 2026-11-05
Omarchy 4.5 (aka Quattro RS!) is the first big feature release since Quattro, and it’s a whopper: over 740 pull requests merged from more than 180 contributors in just twelve weeks. It now offers a traditional desktop mode next to the tiling default. You can install it natively on a M1/M2/M3/Neo MacBooks. And it speaks 50 languages. And a gazillion other features, fixes, and improvements.

Release notes: https://omarchy.org/news/2026/11/omarchy-4-5/

Snapshot: 2026-11-10T09:35:25Z · Data license Apache-2.0 · JSON