# Omarchy — Beautiful Opinionated Linux Distribution by DHH

> A modern, curated Arch-based Linux desktop environment designed for developers who want aesthetics and productivity out of the box.

## Install

Save in your project root:

# Omarchy — Beautiful Opinionated Linux Distribution by DHH

## Quick Use
```bash
# Clone and run the installer on a fresh Arch Linux installation
git clone https://github.com/basecamp/omarchy.git
cd omarchy
./install.sh
```

## Introduction
Omarchy is an opinionated Linux desktop environment built on Arch Linux, created by David Heinemeier Hansson (DHH). It provides a curated set of tools, a tiling window manager, and a polished aesthetic so developers can start working immediately without spending hours configuring their Linux setup.

## What Omarchy Does
- Provides a pre-configured tiling window manager environment with sensible keybindings
- Bundles a curated selection of developer tools, terminal emulators, and editors
- Applies a cohesive visual theme across the desktop, terminal, and status bar
- Automates Arch Linux system configuration with a single install script
- Includes wallpaper, fonts, and color schemes chosen for readability and aesthetics

## Architecture Overview
Omarchy is a collection of dotfiles, configuration scripts, and package lists that transform a base Arch Linux installation into a complete desktop environment. The install script uses pacman and AUR helpers to pull in window manager components, compositor, status bar, application launcher, and developer utilities, then applies configuration files to tie everything together under a unified theme.

## Self-Hosting & Configuration
- Requires a base Arch Linux installation as the starting point
- The install script handles all package installation and configuration automatically
- Individual components can be customized by editing the corresponding dotfiles after installation
- Updates are pulled from the Git repository and reapplied
- Works on both bare-metal hardware and virtual machines with GPU passthrough

## Key Features
- Zero-configuration start for developers switching to Linux from macOS or Windows
- Tiling window manager workflow optimized for keyboard-driven productivity
- Consistent dark theme across all bundled applications
- Lightweight resource footprint compared to full desktop environments like GNOME or KDE
- Open-source and forkable for creating personalized variants

## Comparison with Similar Tools
- **i3/Sway** — Omarchy builds on top of these tiling WMs but adds full environment configuration
- **GNOME/KDE** — full desktop environments with more features but heavier resource usage and less keyboard focus
- **NixOS** — declarative system configuration with stronger reproducibility but a steeper learning curve
- **EndeavourOS** — another Arch-based distro with a graphical installer but less opinionated about desktop setup
- **Regolith** — Ubuntu-based i3 environment; similar concept but on a different base distribution

## FAQ
**Q: Do I need to be an Arch Linux expert to use Omarchy?**
A: Basic Linux familiarity helps, but the install script automates the complex parts. You should be comfortable using a terminal.

**Q: Can I customize the theme and keybindings?**
A: Yes. Omarchy is a set of configuration files that you can modify freely after installation.

**Q: Does it work on laptops with hybrid graphics?**
A: It depends on your hardware. Standard Intel and AMD graphics work well; NVIDIA hybrid setups may require additional configuration.

**Q: Is this a full Linux distribution or a dotfiles collection?**
A: It is closer to a curated dotfiles and package collection that runs on top of Arch Linux, rather than a standalone distribution with its own installer ISO.

## Sources
- https://github.com/basecamp/omarchy
- https://omarchy.com/

---
Source: https://tokrepo.com/en/workflows/asset-2721d574
Author: AI Open Source