$ show omacom/omarchy
Omarchy is a comprehensive, opinionated Linux desktop distribution built on Arch Linux with Hyprland as the tiling window manager and a custom Quickshell-based (Qt QML) desktop shell. It provides a polished, keyboard-driven user experience with extensive theming, a plugin system for shell widgets/panels/services, system management CLI tools (updates, migrations, hardware detection, package management), AI agent integration, clipboard manager, notifications, OSD, and more. The architecture is monolithic around a long-lived QML process, with shell scripts handling system-level operations. The repo includes a full installer, migration scripts, default configurations, and a manual. It is actively maintained with a large test suite and demonstrates strong engineering practices in its QML component library, IPC patterns, and guard evaluation system. While not a research project, it contains utility scripts for audio tuning and disk/network speed tests.
The LLM identified 4 files worth highlighting for reuse:
Exports functions for building rounded rectangle and ring paths for QML ShapePath elements. Supports winding fill, asymmetric border widths, gradient endpoints, and native vs overlay routing. Fully self-contained and reusable in any QML project requiring custom border geometries.
The `guardScript()` method generates an optimized shell script that evaluates all menu visibility, checked, and disabled guards in a single batch by caching repeated command calls. This pattern can be extracted and applied to any declarative menu system where bash guard expressions determine entry availability.
Provides write-once popup file persistence with restore on service start, archival, image copy cleanup, and sanitization. Implemented as a pure JavaScript module with no QML dependencies, making it reusable in any desktop notification system requiring durable popup storage.
A reusable QML component that prevents accidental pointer-driven selection when a popup or overlay is opened programmatically. It captures and discards pointer events for a short time after activation. No internal imports beyond QtQuick; easily extractable for any QML-based shell or application.