# Omarchy Quattro — Official Documentation **Omarchy Quattro** is the official documentation for Omarchy, an opinionated Linux distribution based on Arch, Hyprland, and Quickshell. It is intended for new and experienced users who want to install, configure, navigate, and customize an Omarchy system. The space includes the **Omarchy Manual**, covering installation and dual booting, navigation and window management, top-bar controls, themes, hotkeys, clipboard history, reminders, screenshots, dictation, idle behavior, and the Omarchy CLI. It also documents included applications, system configuration, hardware and networking, updates, dotfiles, troubleshooting, security, snapshots, branding, and custom themes, with practical commands and keyboard shortcuts throughout. Request any document URL with `Accept: text/markdown` to read it as Markdown. ## Documentation - [Omarchy](https://docs.docuwriter.ai/omarchy-quattro/omarchy) ## Manual - [Welcome to Omarchy!](https://docs.docuwriter.ai/omarchy-quattro/manual/welcome-to-omarchy) - [Getting Started](https://docs.docuwriter.ai/omarchy-quattro/manual/getting-started) - [Coming From Mac or Windows](https://docs.docuwriter.ai/omarchy-quattro/manual/coming-from-mac-or-windows) - [Navigation](https://docs.docuwriter.ai/omarchy-quattro/manual/navigation) - [The Top Bar](https://docs.docuwriter.ai/omarchy-quattro/manual/the-top-bar) - [Themes](https://docs.docuwriter.ai/omarchy-quattro/manual/themes) - [Hotkeys](https://docs.docuwriter.ai/omarchy-quattro/manual/hotkeys) - [Unified Clipboard & History](https://docs.docuwriter.ai/omarchy-quattro/manual/unified-clipboard-history) - [Reminders](https://docs.docuwriter.ai/omarchy-quattro/manual/reminders) - [Notices](https://docs.docuwriter.ai/omarchy-quattro/manual/notices) - [Text Extraction & Dictation](https://docs.docuwriter.ai/omarchy-quattro/manual/text-extraction-dictation) - [Screenshots & Recording](https://docs.docuwriter.ai/omarchy-quattro/manual/screenshots-recording) - [Toggles, Idle & the Screensaver](https://docs.docuwriter.ai/omarchy-quattro/manual/toggles-idle-the-screensaver) - [Omarchy CLI](https://docs.docuwriter.ai/omarchy-quattro/manual/omarchy-cli) - [Terminal](https://docs.docuwriter.ai/omarchy-quattro/manual/terminal) - [Neovim](https://docs.docuwriter.ai/omarchy-quattro/manual/neovim) - [AI](https://docs.docuwriter.ai/omarchy-quattro/manual/ai) - [Development Tools](https://docs.docuwriter.ai/omarchy-quattro/manual/development-tools) - [Shell Tools](https://docs.docuwriter.ai/omarchy-quattro/manual/shell-tools) - [Shell Functions](https://docs.docuwriter.ai/omarchy-quattro/manual/shell-functions) - [TUIs](https://docs.docuwriter.ai/omarchy-quattro/manual/tuis) - [GUIs](https://docs.docuwriter.ai/omarchy-quattro/manual/guis) - [Browsers](https://docs.docuwriter.ai/omarchy-quattro/manual/browsers) - [Commercial apps/services](https://docs.docuwriter.ai/omarchy-quattro/manual/commercial-appsservices) - [Web Apps](https://docs.docuwriter.ai/omarchy-quattro/manual/web-apps) - [Gaming](https://docs.docuwriter.ai/omarchy-quattro/manual/gaming) - [Filling out PDFs](https://docs.docuwriter.ai/omarchy-quattro/manual/filling-out-pdfs) - [Windows VM](https://docs.docuwriter.ai/omarchy-quattro/manual/windows-vm) - [Other Packages](https://docs.docuwriter.ai/omarchy-quattro/manual/other-packages) - [Updates](https://docs.docuwriter.ai/omarchy-quattro/manual/updates) - [Dotfiles](https://docs.docuwriter.ai/omarchy-quattro/manual/dotfiles) - [Shell Plugins](https://docs.docuwriter.ai/omarchy-quattro/manual/shell-plugins) - [Monitors](https://docs.docuwriter.ai/omarchy-quattro/manual/monitors) - [Keyboard, Mouse, Trackpad](https://docs.docuwriter.ai/omarchy-quattro/manual/keyboard-mouse-trackpad) - [Networking](https://docs.docuwriter.ai/omarchy-quattro/manual/networking) - [System sleep](https://docs.docuwriter.ai/omarchy-quattro/manual/system-sleep) - [Hardware authentication](https://docs.docuwriter.ai/omarchy-quattro/manual/hardware-authentication) - [Fonts](https://docs.docuwriter.ai/omarchy-quattro/manual/fonts) - [Backgrounds](https://docs.docuwriter.ai/omarchy-quattro/manual/backgrounds) - [Prompt](https://docs.docuwriter.ai/omarchy-quattro/manual/prompt) - [Branding](https://docs.docuwriter.ai/omarchy-quattro/manual/branding) - [Common tweaks](https://docs.docuwriter.ai/omarchy-quattro/manual/common-tweaks) - [Making your own theme](https://docs.docuwriter.ai/omarchy-quattro/manual/making-your-own-theme) - [Mac support](https://docs.docuwriter.ai/omarchy-quattro/manual/mac-support) - [Troubleshooting](https://docs.docuwriter.ai/omarchy-quattro/manual/troubleshooting) - [FAQ](https://docs.docuwriter.ai/omarchy-quattro/manual/faq) - [System snapshots](https://docs.docuwriter.ai/omarchy-quattro/manual/system-snapshots) - [Security](https://docs.docuwriter.ai/omarchy-quattro/manual/security) - [Omarchy on...](https://docs.docuwriter.ai/omarchy-quattro/manual/omarchy-on) - [Dual Boot Install](https://docs.docuwriter.ai/omarchy-quattro/manual/dual-boot-install) - [Unattended Installs](https://docs.docuwriter.ai/omarchy-quattro/manual/unattended-installs) ## Reference - [Speaker tunings](https://docs.docuwriter.ai/omarchy-quattro/reference/speaker-tunings) - [The Omarchy CLI router](https://docs.docuwriter.ai/omarchy-quattro/reference/the-omarchy-cli-router) - [File layout](https://docs.docuwriter.ai/omarchy-quattro/reference/file-layout) - [The Omarchy menu](https://docs.docuwriter.ai/omarchy-quattro/reference/the-omarchy-menu) - [Notifications](https://docs.docuwriter.ai/omarchy-quattro/reference/notifications) - [omarchy-shell](https://docs.docuwriter.ai/omarchy-quattro/reference/omarchy-shell) - [Testing](https://docs.docuwriter.ai/omarchy-quattro/reference/testing) - [Omarchy theming](https://docs.docuwriter.ai/omarchy-quattro/reference/omarchy-theming) - [Omarchy update process](https://docs.docuwriter.ai/omarchy-quattro/reference/omarchy-update-process) ## Contributor Guides - [Acceptance Tests](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/acceptance-tests) - [Command Metadata](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/command-metadata) - [Omarchy Icon Font](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/omarchy-icon-font) - [Install Scripts](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/install-scripts) - [Omarchy migrations](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/omarchy-migrations) - [Omarchy Shell Development](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/omarchy-shell-development) - [Visual Verification](https://docs.docuwriter.ai/omarchy-quattro/contributor-guides/visual-verification)