omarchy-on-cachyos
An installation script that adapts DHH's Omarchy desktop configuration to run on the performance-optimized CachyOS Arch Linux distribution.
What is omarchy-on-cachyos?
Omarchy-on-CachyOS is an installation script that adapts DHH's Omarchy desktop configuration to run on CachyOS, a performance-optimized Arch Linux distribution. It resolves configuration conflicts between the two systems and ensures proper hardware acceleration, particularly for NVIDIA graphics cards. The script automates what would otherwise be a manual and error-prone setup process.
Experienced Arch Linux users who want to run Omarchy's productivity-focused Hyprland desktop on CachyOS's performance-tuned base. Users should be comfortable with command-line interfaces and Arch-specific concepts like AUR helpers.
This script saves users hours of manual configuration by automatically resolving conflicts between Omarchy and CachyOS defaults. It provides a tested, stable integration that maintains the strengths of both systems while fixing known issues like NVIDIA hardware acceleration problems.
Overview
Installation script for DHH's Omarchy on top of CachyOS. (Read the README.md before proceeding!)
Use Cases
Best For
- Setting up Omarchy's Hyprland desktop on CachyOS without manual configuration
- Resolving conflicts between Omarchy and CachyOS default tools and settings
- Fixing NVIDIA hardware acceleration issues on modern Linux desktops
- Creating a productivity-focused Linux workstation with performance optimizations
- Automating complex Linux desktop environment installations
- Maintaining system stability when blending different Linux configuration philosophies
Not Ideal For
- Users new to Arch Linux or uncomfortable with command-line interfaces
- Systems without NVIDIA graphics cards that don't benefit from the driver downgrades
- Projects requiring file systems other than BTRFS or different snapshot managers
- Those preferring a display manager-free boot like Omarchy's default LUKS encryption setup
Pros & Cons
Pros
Intelligently chooses between CachyOS and Omarchy defaults for tools like AUR helpers (Yay over Paru) and shells (Fish over Bash), as documented in the README's philosophy section.
Automatically downgrades to proprietary NVIDIA 580xx drivers using CachyOS's chwd tool, fixing hardware acceleration and browser flickering issues, which the README explicitly addresses as a deliberate choice.
Works with both encrypted and non-encrypted CachyOS installations, leaving full disk encryption decisions to the user, unlike Omarchy's enforced encryption.
Configures Mise version manager activation for the Fish shell, ensuring compatibility with CachyOS's default while integrating Omarchy's tooling.
Cons
Requires BTRFS with Snapper and Fish shell as mandatory choices during CachyOS installation, limiting flexibility for users with different preferences or existing setups.
The README admits the script hasn't been extensively tested beyond the author's machine, posing risks of instability on varied hardware or configurations.
Unlike Omarchy's default autostart with LUKS, this script assumes a display manager is installed and doesn't configure Hyprland to start automatically without one, adding complexity for minimalists.
Frequently Asked Questions
Related Projects
hyprwhsprNative speech-to-text for Linux - Fast, accurate and private system-wide dictation
omarchy-nixAn opinionated NixOS config based on DHH's Omarchy
omarchy-cachyosOpinionated CachyOS/Hyprland Setup
OkimarchyOmarchy + Niri
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.