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.

• 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.