# omarchy | Omacom | Knowledge Base | Instagit Beautiful, Modern & Opinionated Linux GitHub Stars: 35k Repository: https://github.com/omacom/omarchy --- ## Articles ### [How to Create Menu Entries with Guards and Provider Functions in Omarchy](/omacom/omarchy/how-to-create-menu-entries-omarchy-guards-providers) Learn to create dynamic Omarchy menu entries using when guards and action provider functions in omarchy-menu.jsonc. Build context-aware menus easily. - Tags: how-to-guide - Published: 2026-09-13 ### [How Omarchy Manages Version and Release Channels](/omacom/omarchy/omarchy-version-release-channels-management) Discover how Omarchy manages version and release channels using Bash utilities that inspect Pacman package state, parse mirrorlist comments, and detect Git metadata for development checkouts. - Tags: internals - Published: 2026-09-13 ### [How Omarchy Manages System Snapshots with Snapper: Complete Technical Guide](/omacom/omarchy/omarchy-system-snapshots-snapper) Learn how Omarchy uses Snapper for automated Btrfs snapshots before system updates. This guide covers retention policies and Limine bootloader restoration. - Tags: how-to-guide - Published: 2026-09-13 ### [Omarchy Boot System Components: mkinitcpio, Limine, and Plymouth Explained](/omacom/omarchy/omarchy-boot-system-components) Discover the Omarchy boot system components mkinitcpio, Limine, and Plymouth. Learn how these tools create a unified and graphical boot experience with custom hooks and scripts. - Tags: deep-dive - Published: 2026-09-13 ### [How the Omarchy Notification System Routes Messages: CLI to QML Architecture](/omacom/omarchy/omarchy-notification-system-routing) Discover how the Omarchy notification system routes messages. Learn about the CLI to QML architecture and message persistence for desktop toasts. - Tags: internals - Published: 2026-09-13 ### [How Omarchy Integrates with Hyprland Using Shell Commands and IPC](/omacom/omarchy/omarchy-hyprland-integration-commands) Discover how Omarchy integrates with Hyprland using shell commands and IPC. Control workspaces, monitors, and layouts with simple commands like omarchy-toggle-bar and omarchy-refresh-config. Learn more now. - Tags: how-to-guide - Published: 2026-09-13 ### [How Feature Toggles Work with the toggle-* Command Prefix in Omarchy](/omacom/omarchy/how-feature-toggles-work-omarchy-toggle-command) Discover how Omarchy uses feature toggles with the toggle-* command prefix. Learn to manage feature flags efficiently via simple file presence in your state directory. - Tags: how-to-guide - Published: 2026-09-13 ### [How Omarchy Package Management Helpers Support Pacman and AUR: A Complete Guide](/omacom/omarchy/omarchy-package-management-helpers-pacman-aur) Learn how Omarchy package management helpers support Pacman and AUR with idempotent operations. This guide details our Bash wrappers for native Arch Linux tools. - Tags: how-to-guide - Published: 2026-09-13 ### [How to Use omarchy-debug and omarchy-upload-log for Omarchy Diagnostics](/omacom/omarchy/how-to-use-omarchy-debug-upload-log-diagnostics) Master Omarchy diagnostics with omarchy-debug and omarchy-upload-log. Effortlessly gather system snapshots and logs for faster troubleshooting. - Tags: how-to-guide - Published: 2026-09-13 ### [How the Omarchy Update Process Pipeline Works: A Complete Technical Guide](/omacom/omarchy/omarchy-update-process-pipeline) Understand the omarchy update process pipeline. This guide details how the `omarchy update` command manages system updates, validation, package upgrades, and migrations securely. - Tags: deep-dive - Published: 2026-09-13 ### [How to Add User Hooks in Omarchy’s Config Directory: A Complete Setup Guide](/omacom/omarchy/how-to-add-user-hooks-omarchy-config) Learn how to add user hooks in Omarchy's config directory. Follow our guide to place executable scripts or use the command for easy setup and permission management. - Tags: how-to-guide - Published: 2026-09-13 ### [How Omarchy Install Scripts and Finalize Scripts Function](/omacom/omarchy/omarchy-install-scripts-finalize-function) Understand how Omarchy install scripts and finalize scripts function across three key phases: system installation, per-user finalization, and first-run graphical setup. Streamline your OS configuration. - Tags: how-to-guide - Published: 2026-09-13 ### [How to Create a New Theme for Omarchy Using colors.toml](/omacom/omarchy/how-to-create-new-theme-omarchy-colors-toml) Learn how to create a new Omarchy theme by defining a colors.toml file in your config directory and activating it with a simple command for custom system-wide palettes. - Tags: how-to-guide - Published: 2026-09-13 ### [How Shell IPC Works Between Omarchy bin/ Scripts and the Quickshell Instance](/omacom/omarchy/omarchy-shell-ipc-bin-quickshell) Learn how Omarchy shell IPC works between bin/ scripts and Quickshell. Discover how JSON payloads are marshaled through Unix-domain sockets for execution via the quickshell ipc command. - Tags: internals - Published: 2026-09-13 ### [How to Write and Structure CLI Tests for Omarchy: Complete Guide to the TAP-Flavored Framework](/omacom/omarchy/how-to-write-omarchy-cli-tests) Learn to write and structure CLI tests for Omarchy using its TAP-flavored framework. This guide covers isolated execution, schema validation, and immediate failure reporting. - Tags: testing - Published: 2026-09-13 ### [How Omarchy Chooses Between sudo and pkexec for Privileged Commands](/omacom/omarchy/omarchy-privileged-commands-sudo-pkexec-choice) Discover how Omarchy intelligently selects between sudo and pkexec for privileged commands. Learn its logic for interactive vs. graphical sessions. - Tags: deep-dive - Published: 2026-09-13 ### [How omarchy-refresh-config Handles Default Configurations and Backups in Omarchy](/omacom/omarchy/omarchy-refresh-config-defaults-backups) Discover how omarchy-refresh-config synchronizes default configs, backs up customizations, and shows diffs in Omarchy. Learn about its intelligent file handling. - Tags: how-to-guide - Published: 2026-09-13 ### [How to Add a New Hardware Detection Command (hw-* Prefix) in Omarchy](/omacom/omarchy/how-to-add-hardware-detection-command-omarchy) Easily add custom hardware detection commands with the hw-* prefix in Omarchy. Create a bash script in bin/ to integrate new hardware detection. - Tags: how-to-guide - Published: 2026-09-13 ### [How the Omarchy Menu System Works: JSONC Schema, Guards, and Providers](/omacom/omarchy/omarchy-menu-system-jsonc-schema-guards-providers) Discover how the Omarchy menu system uses JSONC schema, guards, and providers to build dynamic hierarchical menus. Learn about dotted identifiers and QML providers. - Tags: internals - Published: 2026-09-13 ### [How to Create a New Bar Widget Plugin for the Omarchy Shell](/omacom/omarchy/how-to-create-new-bar-widget-plugin-omarchy) Learn to create a new bar widget plugin for the Omarchy shell. Add a QML file, JavaScript model, and manifest to register your custom widget with the shell. - Tags: how-to-guide - Published: 2026-09-13 ### [Understanding the Omarchy Migration Structure: A Per-User Shell-Based Framework](/omacom/omarchy/omarchy-migrations-structure) Explore the Omarchy migration structure, a per-user shell-based framework. Learn how timestamped scripts and marker files ensure safe, idempotent environment updates in omarchy. - Tags: architecture - Published: 2026-09-13 ### [How Omarchy Theme Templates Use `{{ Variable }}` Placeholders: Complete Guide](/omacom/omarchy/how-theme-templates-use-variable-placeholders-omarchy) Learn how Omarchy theme templates use {{ variable }} placeholders with colors.toml, supporting hex, RGB, and gradient parsing for easy customization. - Tags: how-to-guide - Published: 2026-09-13 ### [Understanding the Quickshell Plugin System with Manifests and Kinds](/omacom/omarchy/understanding-quickshell-plugin-system-manifests-kinds) Explore Omarchy's Quickshell plugin system. Learn how JSON manifests define plugin capabilities, entry points, and kinds, validated by the PluginRegistry for seamless shell integration. - Tags: deep-dive - Published: 2026-09-13 ### [How to Add a New Command to the Omarchy CLI Router](/omacom/omarchy/how-to-add-new-command-to-omarchy-cli-router) Easily add new commands to the Omarchy CLI router. Create executable files in bin/ and use metadata comments for auto-discovery and registration. Streamline your workflow today. - Tags: how-to-guide - Published: 2026-09-13 ### [How to Report a Bug in the Omarchy CLI: A Complete Guide](/omacom/omarchy/how-to-report-a-bug-in-omarchy-cli) Learn how to report a bug in the Omarchy CLI. Collect diagnostics, gather screenshots, and file a detailed issue on GitHub to help improve Omarchy. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Uninstall the Omarchy CLI: Complete Removal Guide](/omacom/omarchy/how-to-uninstall-omarchy-cli) Completely uninstall Omarchy CLI by deleting bin directories removing the root folder clearing user config and cleaning your PATH variable. Follow our guide for full removal. - Tags: how-to-guide - Published: 2026-09-12 ### [Omarchy Release Cycle Explained: Four Channels and Update Strategy](/omacom/omarchy/what-is-the-release-cycle-for-omarchy) Understand the omarchy release cycle. Explore four channels stable RC edge dev and master update strategies to balance stability and new features effectively. - Tags: release-cycle - Published: 2026-09-12 ### [How the Omarchy CLI Interacts with External Tools and System Components](/omacom/omarchy/how-does-omarchy-cli-interact-with-other-tools) Discover how the Omarchy CLI orchestrates operations, interacts with desktop environments via DBus, and abstracts system utilities like pacman and bluetoothctl for seamless integration. - Tags: internals - Published: 2026-09-12 ### [Omarchy CLI Tutorials: Complete Guide to Command-Line Usage and Automation](/omacom/omarchy/are-there-any-tutorials-for-omarchy-cli) Explore Omarchy CLI tutorials to master command-line usage and automation. This guide details scripting, automation, and extension of the omacom/omarchy CLI. - Tags: tutorial - Published: 2026-09-12 ### [How to Update the Omarchy CLI: A Complete Guide to Safe System Upgrades](/omacom/omarchy/how-to-update-omarchy-cli) Update Omarchy CLI safely with atomic upgrades and automatic Btrfs snapshots. Learn how to perform system upgrades effortlessly using the omarchy update command. - Tags: how-to-guide - Published: 2026-09-12 ### [Best Practices for Using the Omarchy CLI: A Complete Developer Guide](/omacom/omarchy/what-are-the-best-practices-for-using-omarchy-cli) Master the Omarchy CLI with this developer guide. Learn best practices for routing commands, validation, and JSON output for robust scripting and automation. - Tags: best-practices - Published: 2026-09-12 ### [How to Get Help with Omarchy CLI Commands: A Complete Guide to the Router and Metadata System](/omacom/omarchy/how-to-get-help-with-omarchy-cli-commands) Master Omarchy CLI commands with our guide. Learn to use the router and metadata system to access help for global commands, groups, and specific scripts easily. - Tags: how-to-guide - Published: 2026-09-12 ### [What Is the Purpose of the bin Directory in Omarchy? CLI Architecture Explained](/omacom/omarchy/what-is-the-purpose-of-the-bin-directory-in-omarchy) Discover the purpose of the bin directory in Omarchy. Learn how this CLI architecture uses executable Bash scripts to translate commands into binary operations. - Tags: architecture - Published: 2026-09-12 ### [How to Extend Omarchy CLI Functionality: Adding Custom Commands and Groups](/omacom/omarchy/how-to-extend-omarchy-cli-functionality) Extend Omarchy CLI functionality by creating custom commands and groups. Learn the naming conventions and metadata requirements to build your own executable scripts for enhanced workflows. - Tags: how-to-guide - Published: 2026-09-12 ### [Where Are Omarchy Configuration Files Located? A Complete Directory Guide](/omacom/omarchy/where-are-the-configuration-files-for-omarchy) Find omarchy configuration files easily. Discover their locations in the config directory, user home, and application-specific paths for seamless customization. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Debug Omarchy CLI Issues: A Complete Troubleshooting Guide](/omacom/omarchy/how-to-debug-omarchy-cli-issues) Troubleshoot omarchy CLI issues with this complete guide. Learn to validate metadata permissions and inspect command configurations effectively for smoother operations. - Tags: how-to-guide - Published: 2026-09-12 ### [What Are the Dependencies for the Omarchy CLI?](/omacom/omarchy/what-are-the-dependencies-for-omarchy-cli) Discover Omarchy CLI dependencies. Learn about required system utilities like bash jq curl and essential Arch Linux packages needed for seamless operation. Get your Omarchy CLI setup fast. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Run Omarchy Commands Without Installation: A Complete Guide](/omacom/omarchy/how-to-run-omarchy-commands-without-installation) Learn how to run Omarchy commands without installation from the omacom/omarchy repository. Easily execute commands using the bin omarchy script or by adding bin to your PATH. Get started now - Tags: how-to-guide - Published: 2026-09-12 ### [How to Build Omarchy from the Repository: Complete Source Compilation Guide](/omacom/omarchy/how-to-build-omarchy-from-the-repository) Build Omarchy from the omacom/omarchy repository with this guide. Compile source code, install dependencies, bootstrap toolchains, and build PKGBUILDs for a complete setup. - Tags: how-to-guide - Published: 2026-09-12 ### [What Programming Language Is the Omarchy CLI Written In?](/omacom/omarchy/what-programming-language-is-omarchy-cli-written-in) Discover the programming language powering the Omarchy CLI. Learn how it uses Bash, associative arrays, and metadata parsing for efficient command routing. - Tags: internals - Published: 2026-09-12 ### [How to Contribute to Omarchy CLI Development: A Complete Guide](/omacom/omarchy/how-to-contribute-to-omarchy-cli-development) Contribute to Omarchy CLI development by creating executable scripts and adding tests. Learn the process and enhance the omarchy project today. - Tags: how-to-guide - Published: 2026-09-12 ### [Where Is the Omarchy CLI Executable Located?](/omacom/omarchy/where-is-the-omarchy-cli-executable-located) Find the omarchy CLI executable at bin/omarchy in the omacom/omarchy repo. This Bash dispatcher routes user input to sub-command binaries. - Tags: how-to-guide - Published: 2026-09-12 ### [How the Omarchy CLI Handles Arguments and Options](/omacom/omarchy/how-does-omarchy-cli-handle-arguments-and-options) Learn how the Omarchy CLI handles arguments and options using its two-tier resolution system for efficient command routing and parameter enforcement. Discover its fast filename match and metadata-driven approach. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Customize Omarchy CLI Commands: A Complete Guide](/omacom/omarchy/can-i-customize-omarchy-cli-commands) Customize Omarchy CLI commands by creating scripts in bin/ and adding metadata headers. Discover how to easily extend Omarchy's functionality without extra config files. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Install Omarchy from Source: ISO Deployment and Repository Configuration Guide](/omacom/omarchy/how-to-install-omarchy-from-source) Install Omarchy from source by deploying the official ISO. Clone the repository to customize your system with post-installation scripts for a tailored Omarchy experience. - Tags: how-to-guide - Published: 2026-09-12 ### [Omarchy CLI Commands: Complete Guide to 70+ Command Groups](/omacom/omarchy/what-are-the-main-commands-in-omarchy-cli) Explore over 70 omarchy CLI command groups with this comprehensive guide. Learn to navigate and utilize the omarchy command line interface effectively for your projects. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Set Up the Omarchy CLI Locally: A Complete Installation Guide](/omacom/omarchy/how-to-set-up-omarchy-cli-locally) Learn how to set up the Omarchy CLI locally with our complete installation guide. Clone the repository, set environment variables, and add the bin directory to your PATH for quick access. - Tags: how-to-guide - Published: 2026-09-12 ### [How to Migrate an Omarchy Theme from alacritty.toml to colors.toml](/omacom/omarchy/migrating-an-omarchy-theme-from-alacritty-toml-to-colorstoml) Learn how to migrate your Omarchy theme from alacritty.toml to colors.toml. This guide simplifies theme management and ensures compatibility with the latest Omarchy structure. - Tags: migration-guide - Published: 2026-09-11 ### [Understanding the Omarchy-Hook System: Events, Triggers, and Custom Scripts](/omacom/omarchy/what-is-the-omarchy-hook-system-and-what-triggers-it) Discover the Omarchy-Hook system, an automation framework for Omarchy. Learn how system events like post-boot, post-update, and theme changes trigger custom scripts. - Tags: deep-dive - Published: 2026-09-11 ### [Testing Omarchy Theme Changes with `omarchy dev theme-preview`](/omacom/omarchy/testing-omarchy-theme-changes-with-omarchy-dev-theme-preview) Easily test Omarchy theme changes with omarchy dev theme-preview. Instantly preview color palettes, check WCAG contrast ratios, and apply changes directly in your terminal. - Tags: how-to-guide - Published: 2026-09-11 ### [GROUP_DESCRIPTIONS in Omarchy: How Command Group Metadata Shapes CLI Output](/omacom/omarchy/what-are-groupdescriptions-and-how-do-they-influence-omarchy-command-listings) Learn how GROUP_DESCRIPTIONS in Omarchy's bin/omarchy Bash script create categorized CLI help listings using command group metadata for enhanced user experience. - Tags: internals - Published: 2026-09-11 ### [How Omarchy Command Fallback Route Resolution Works](/omacom/omarchy/how-does-omarchy-command-fallback-route-resolution-function) Discover how Omarchy command fallback route resolution ensures every binary is callable using dual routing tables for explicit and filename-derived paths. Learn more. - Tags: internals - Published: 2026-09-11 ### [Creating a Custom Omarchy Lock Screen Theme with shell.lock.toml](/omacom/omarchy/creating-a-custom-omarchy-lock-screen-theme-with-shelllocktoml) Create a custom Omarchy lock screen theme using shell.lock.toml. Override wallpapers, colors, and effects to personalize your Quickshell experience. - Tags: how-to-guide - Published: 2026-09-11 ### [Understanding the hypr_gradient Template Helper in Omarchy](/omacom/omarchy/what-is-the-hyprgradient-template-helper-in-omarchy-and-how-does-it-work) Explore the hypr_gradient template helper in Omarchy. Learn how this Jinja-style function converts theme color tokens into Hyprland-compatible Lua tables or strings for gradients and solid colors. - Tags: deep-dive - Published: 2026-09-11 ### [Configuring Omarchy Bar Position and Transparency: A Complete Guide](/omacom/omarchy/configuring-omarchy-bar-position-and-transparency) Master omarchy bar position and transparency. Learn how to effortlessly configure these settings using CLI commands, gestures, or the Style menu for instant visual customization. - Tags: how-to-guide - Published: 2026-09-11 ### [How the Fast Path Dispatch Optimizes Omarchy Command Resolution](/omacom/omarchy/how-does-the-fast-path-dispatch-optimize-omarchy-command-resolution) Learn how the fast path dispatch optimizes Omarchy command resolution by directly executing binaries, bypassing parsing and conflict resolution for faster command execution. - Tags: internals - Published: 2026-09-11 ### [How to Add a New CLI Command to the Omarchy Binary: A Complete Guide](/omacom/omarchy/adding-a-new-cli-command-to-the-omarchy-binary) Learn how to add a new CLI command to the omarchy binary. Create executable Bash scripts in bin/ and follow the naming convention to extend omarchy functionality. - Tags: how-to-guide - Published: 2026-09-11 ### [How IPC Communication Works Between bin/omarchy and the Omarchy Shell](/omacom/omarchy/how-does-ipc-communication-work-between-binomarchy-and-the-shell) Discover how bin/omarchy uses Quickshell's ipc client over Unix sockets to communicate with QML services for shell commands. Learn about Omarchy IPC. - Tags: internals - Published: 2026-09-11 ### [Difference Between User Themes and Git-Installed Themes in Omarchy](/omacom/omarchy/difference-between-user-themes-and-git-installed-themes-in-omarchy) Discover the difference between user themes and Git-installed themes in Omarchy. Learn how each type is managed and how they override built-in styles for customization. - Tags: deep-dive - Published: 2026-09-11 ### [Theming Omarchy Shell Borders with Gradients Using shell.toml](/omacom/omarchy/theming-omarchy-shell-borders-with-gradients-using-shelltoml) Customize Omarchy shell borders with vibrant gradients by defining colors in colors.toml and applying them in shell.lock.toml. Elevate your shell's appearance today. - Tags: how-to-guide - Published: 2026-09-11 ### [How to Add a New Template File to the Omarchy Theming System](/omacom/omarchy/adding-a-new-template-file-to-the-omarchy-theming-system) Easily add a new template file to the Omarchy theming system. Create a *.tpl file and run omarchy-theme-set-templates to render your custom theme. - Tags: how-to-guide - Published: 2026-09-11 ### [Complete Guide to Omarchy Command Metadata Keys: group, name, summary, and More](/omacom/omarchy/what-are-the-omarchy-command-metadata-keys-omarchygroup-omonarchyname-omonarchysummary) Explore Omarchy command metadata keys like group name and summary to enhance your CLI. Learn how to automatically discover and validate sub-commands with this comprehensive guide. - Tags: deep-dive - Published: 2026-09-11 ### [How to Configure Omarchy Shell with shell.json for Bar, Idle Timeout, and Plugins](/omacom/omarchy/configuring-omarchy-shell-with-shelljson-for-bar-idle-timeout-and-plugins) Learn to configure Omarchy shell.json for bar auto-hide, idle timeouts, and plugins. Customize your Quickshell desktop environment efficiently. - Tags: how-to-guide - Published: 2026-09-11 ### [How to Create a Custom Omarchy Shell Plugin Using manifest.json](/omacom/omarchy/how-to-create-a-custom-omarchy-shell-plugin-using-manifestjson) Learn to create a custom Omarchy shell plugin using manifest.json. Effortlessly add functionality to your shell without code registration. - Tags: how-to-guide - Published: 2026-09-11 ### [Debugging Omarchy CLI Routing Issues: Route Collisions and Missing Commands](/omacom/omarchy/debugging-omarchy-cli-routing-issues-like-route-collisions-or-missing-commands) Debug Omarchy CLI routing issues like route collisions and missing commands. Inspect associative arrays in bin/omarchy and verify bin/omarchy- naming. Resolve duplicate registrations. - Tags: how-to-guide - Published: 2026-09-11 ### [Understanding the Omarchy Theme Activation Flow and `omarchy-theme-set` Functionality](/omacom/omarchy/understanding-the-theme-activation-flow-and-omarchy-theme-set-functionality) Learn the Omarchy theme activation flow with omarchy-theme-set. Discover how this command validates inputs, filters files, stages assets, and executes commands efficiently. - Tags: deep-dive - Published: 2026-09-11 ### [How to Add a Custom Bar Widget to the Omarchy Bar Layout: A Complete Guide](/omacom/omarchy/how-to-add-a-custom-bar-widget-to-the-omarchy-bar-layout) Learn to add a custom bar widget to Omarchy easily. Follow this guide to create a plugin, implement a QML component, and register your new widget for enhanced functionality. - Tags: how-to-guide - Published: 2026-09-11 ### [How the Omarchy Shell Plugin System Integrates with Quickshell: A Technical Deep Dive](/omacom/omarchy/how-does-the-omarchy-shell-plugin-system-interact-with-quickshell) Discover how the Omarchy shell plugin system integrates with Quickshell via a QML registry. Learn about manifest validation and dynamic injection for third-party extensions. - Tags: deep-dive - Published: 2026-09-11 ### [Creating a Custom Omarchy Theme with colors.toml and Template Placeholders](/omacom/omarchy/creating-a-custom-omarchy-theme-with-colorstomland-template-placeholders) Learn to create a custom Omarchy theme by customizing colors.toml and using template placeholders. Generate desktop configurations easily with Omarchy. - Tags: how-to-guide - Published: 2026-09-11 ### [How Omarchy Resolves CLI Commands to Binaries: Fast‑Path and Metadata Routing](/omacom/omarchy/how-to-resolve-cli-commands-in-omarchy-like-omarchy-theme-set-foo-to-binaries) Discover how Omarchy resolves CLI commands to binaries using fast-path and metadata routing. Learn about its efficient pattern probing and fallback mechanisms for seamless command execution. - Tags: internals - Published: 2026-09-11 ### [How the Omarchy Branding System Works with Plymouth, About, and Screensaver](/omacom/omarchy/omarchy-branding-system-plymouth-about-screensaver) Learn how the Omarchy branding system creates custom ASCII art for Plymouth, About dialogs, and screensavers using simple text files and helper commands. Customize your system's visual identity. - Tags: deep-dive - Published: 2026-09-10 ### [Omarchy Install Scripts: Pre‑install Hardware Fixes and Service Setup Explained](/omacom/omarchy/omarchy-install-scripts-preinstalls-service-setup) Explore Omarchy install scripts for automated pre-install hardware fixes, package installation, user configuration, and service setup. Ensure a deterministic first boot. - Tags: how-to-guide - Published: 2026-09-10 ### [How Omarchy Handles Battery and Power Profile Management: Event-Driven UPower Integration](/omacom/omarchy/omarchy-battery-power-profile-management) Discover how Omarchy manages battery and power profiles with event-driven UPower integration. Get low-battery warnings and automatic profile switching for seamless power management. - Tags: deep-dive - Published: 2026-09-10 ### [How Omarchy Manages Network Panels: Wi-Fi Bandwidth and Tailscale Integration](/omacom/omarchy/omarchy-network-panels-bandwidth-wifi-tailscale) Learn how Omarchy manages network panels displaying Wi-Fi bandwidth and Tailscale integration. Discover its plugin architecture and data parsing methods. - Tags: how-to-guide - Published: 2026-09-10 ### [How the Omarchy Idle, Lock, and Screensaver Service Works](/omacom/omarchy/omarchy-idle-lock-screensaver-service) Discover how the Omarchy idle service monitors user input and triggers screensaver or session locks. Learn about its configurable timeouts and IPC for status bar integration. - Tags: internals - Published: 2026-09-10 ### [How to Write and Run Migrations in the Omarchy Migration System](/omacom/omarchy/omarchy-migration-system-writing-running-migrations) Learn to write and run Omarchy migrations using timestamped shell scripts. Effortlessly manage configuration changes and repairs with this powerful system. - Tags: how-to-guide - Published: 2026-09-10 ### [How Omarchy Configures Security for Fingerprint and FIDO2 Hardware Authentication](/omacom/omarchy/omarchy-security-setup-fingerprint-fido2-hardware-authentication) Learn how Omarchy configures security for fingerprint and FIDO2 hardware authentication using PAM, Polkit, and Quickshell UI. Secure your lock screens and commands today. - Tags: how-to-guide - Published: 2026-09-10 ### [Omarchy Audio Pipeline: Output Switching and Volume Control Architecture](/omacom/omarchy/omarchy-audio-pipeline-output-switching-volume-control) Discover how the Omarchy audio pipeline manages output switching and volume control using PipeWire and WirePlumber. Learn to switch audio outputs seamlessly. - Tags: architecture - Published: 2026-09-10 ### [How Omarchy Integrates with Hyprland: Window Gaps, Monitor Focus, and Reload Guards](/omacom/omarchy/omarchy-hyprland-integration-window-gaps-monitor-focus-reload-guard) Learn how Omarchy integrates with Hyprland using Lua modules for reload guards, dynamic window gaps, and monitor focus. Enhance your tiling window manager experience. - Tags: how-to-guide - Published: 2026-09-10 ### [Omarchy Hardware Detection Commands (hw-*): Complete Reference](/omacom/omarchy/omarchy-hardware-detection-commands-hw-star) Discover Omarchy hardware detection commands (hw-*). Learn how these utilities probe hardware via sysfs data to confirm presence with exit status 0. - Tags: api-reference - Published: 2026-09-10 ### [Omarchy Update Pipeline for User Notifications and Orphan Packages](/omacom/omarchy/omarchy-update-pipeline-user-notifications-orphan-packages) Discover the Omarchy update pipeline for user notifications and orphan package cleanup. Learn how the master script orchestrates desktop alerts and dependency management. - Tags: how-to-guide - Published: 2026-09-10 ### [How to Add Commands to the Omarchy CLI: Metadata, Routing, and Registration](/omacom/omarchy/add-commands-omarchy-cli-metadata-routing) Learn to add commands to the Omarchy CLI. Discover how to embed metadata, configure routing, and register new commands effortlessly for your Go applications. - Tags: how-to-guide - Published: 2026-09-10 ### [How the Omarchy Menu System Works: Entries, Guards, and Providers Explained](/omacom/omarchy/omarchy-menu-system-entries-guards-providers) Understand the Omarchy menu system. Learn how JSONC entries, Bash guards, and IPC providers create dynamic, responsive menus. - Tags: internals - Published: 2026-09-10 ### [Omarchy Service Architecture: First-Party vs Third-Party Service Isolation](/omacom/omarchy/omarchy-service-architecture-first-party-vs-third-party) Understand Omarchy service architecture. Learn how Omarchy isolates third-party services from built-in ones using Quickshell for enhanced security and control. - Tags: architecture - Published: 2026-09-10 ### [Omarchy Bar Widget Panels Lifecycle: Summon, Hide, and Toggle Mechanisms](/omacom/omarchy/omarchy-bar-widget-panel-summon-hide-toggle-lifecycle) Discover the Omarchy bar widget panels lifecycle: summon, hide, and toggle mechanisms. Learn how pickPanelSlot summons, hides, and toggles panels in the QML layer. - Tags: internals - Published: 2026-09-10 ### [How the Omarchy Plugin Registry Handles Discovery, Loading, and Hot Reload](/omacom/omarchy/omarchy-plugin-registry-discovery-loading-hot-reload) Learn how the Omarchy plugin registry discovers, loads, and hot reloads plugins using manifest files, QML loaders, and file system watchers for seamless development. - Tags: internals - Published: 2026-09-10 ### [Omarchy Shell Configuration (shell.json) Reference: A Complete Guide](/omacom/omarchy/omarchy-shell-configuration-shell-json-reference) Explore the Omarchy shell.json configuration reference. Master your Quickshell environment by customizing the status bar layout, plugins, and idle behavior with instant hot-reloading. - Tags: api-reference - Published: 2026-09-10 ### [How the Omarchy Theme System Handles Templates, Colors, and Variables](/omacom/omarchy/omarchy-theme-system-templates-colors-variables) Discover how the Omarchy theme system dynamically generates UI configurations by parsing TOML color palettes and substituting template variables with a Bash driver. - Tags: deep-dive - Published: 2026-09-10 ### [How to Create a Custom Omarchy Bar Widget: A Step-by-Step Guide](/omacom/omarchy/create-custom-omarchy-bar-widget) Learn to create a custom Omarchy bar widget with this step-by-step guide. Build a QML component and JSON manifest, then enable the plugin to personalize your Omarchy experience. - Tags: how-to-guide - Published: 2026-09-10 ### [How the Omarchy CLI Command Router Works: File-System Driven Dispatch](/omacom/omarchy/how-omarchy-cli-command-router-works) Discover how the Omarchy CLI command router uses a file-system driven approach with two-phase resolution for efficient command dispatch. Learn more about this lightweight dispatcher. - Tags: internals - Published: 2026-09-10 ### [How to Contribute a New Task Guide Under agents/skills/ in Omarchy](/omacom/omarchy/how-to-contribute-new-task-guide-agents-skills-following-conventions) Learn to contribute a new task guide to Omarchy in agents/skills/. Follow our easy steps for Markdown, H1 headings, structure, and AGENTS.md registration. - Tags: how-to-guide - Published: 2026-09-09 ### [How Quickshell QML Modules Interact with the Environment Bootstrap in Omarchy](/omacom/omarchy/how-quickshell-qml-modules-shell-interact-env-bootstrap-default-bash-env-bootstrap) Discover how Omarchy Quickshell QML modules use Quickshell env() to access environment variables from bash env bootstrap for seamless configuration. - Tags: internals - Published: 2026-09-09 ### [How the omarchy-dev-link and omarchy-dev-unlink Commands Set Up a Development Checkout](/omacom/omarchy/how-omarchy-dev-link-omarchy-dev-unlink-commands-set-up-development-checkout) Learn how omarchy-dev-link and omarchy-dev-unlink commands manage your OMARCHY_PATH and sudo secure_path to easily switch between packaged Omarchy and local development checkouts. - Tags: how-to-guide - Published: 2026-09-09 ### [How omarchy-migrate-notify.service Triggers Migrations on Login Without Blocking](/omacom/omarchy/how-omarchy-migrate-notify-service-triggers-migrations-login-without-blocking) Discover how omarchy-migrate-notify.service triggers migrations on login without blocking. Learn about its lightweight helper for efficient, non-intrusive updates. - Tags: internals - Published: 2026-09-09 ### [Omarchy Provision User vs Reinstall Configs: Scope and Use Cases Explained](/omacom/omarchy/how-omarchy-provision-user-differs-omarchy-reinstall-configs-scope-use-case) Understand omarchy-provision-user vs omarchy-reinstall-configs. Learn when to use each for user provisioning and config resets in omarchy. - Tags: deep-dive - Published: 2026-09-09 ### [How Omarchy Hardware Detection Commands Like `omarchy-hw-asus-rog` Return Exit Codes for Conditionals](/omacom/omarchy/how-hardware-detection-commands-omarchy-hw-asus-rog-return-exit-codes-conditionals) Learn how Omarchy hardware detection commands like omarchy-hw-asus-rog use exit codes for shell conditionals. Discover how exit status ensures 0 for success and non-zero for failure. - Tags: internals - Published: 2026-09-09 ### [How Kitty Defaults Are Loaded and User Overrides Safely Preserved in Omarchy](/omacom/omarchy/how-kitty-defaults-loaded-user-overrides-safely-preserved) Learn how Omarchy safely loads Kitty defaults and preserves user overrides using SHA-256 checks and backups, ensuring your customizations survive updates. - Tags: internals - Published: 2026-09-09 ### [Omarchy Privilege Escalation Pattern: How SKILL.md Chooses sudo vs pkexec](/omacom/omarchy/how-privilege-escalation-pattern-default-agents-skills-omarchy-skill-md-chooses-sudo-vs-pkexec) Discover how Omarchy's SKILL.md chooses between sudo and pkexec for privilege escalation. Learn its automatic selection for interactive vs non-interactive environments. - Tags: internals - Published: 2026-09-09 ### [How to Debug Routing Surprises with omarchy commands --all --json](/omacom/omarchy/how-to-debug-routing-surprises-omarchy-commands-all-json) Debug routing surprises with omarchy commands --all --json. Inspect your complete routing table, guard preludes, hidden flags, and group assignments to understand command path resolution. - Tags: how-to-guide - Published: 2026-09-09 ### [How to Debug Routing Surprises with `omarchy --help`](/omacom/omarchy/how-to-debug-routing-surprises-omarchy-route-help) Uncover routing surprises in Omarchy by using omarchy --help. This command inspects arguments and displays group or command-specific help without running the binary. - Tags: how-to-guide - Published: 2026-09-09 ### [How OMARCHY_PATH Is Set and Why Omarchy Commands Rely on It Instead of $HOME](/omacom/omarchy/how-omarchy-path-set-why-commands-rely-on-it-over-home) Learn how OMARCHY_PATH is set in Omarchy, allowing commands to run independently of $HOME. Discover the critical role of this environment variable for Omarchy binaries and configurations. - Tags: internals - Published: 2026-09-09 ### [How the Omarchy Testing Suite Is Organized: CLI, Shell, and Acceptance Layers](/omacom/omarchy/how-omarchy-testing-suite-organized-test-cli-test-shell-test-acceptance-d) Discover how the Omarchy testing suite organizes CLI, shell, and acceptance layers in test/cli, test/shell.d/, and test/acceptance.d/ for effective validation. Learn more. - Tags: how-to-guide - Published: 2026-09-09 ### [How omarchy-refresh-config Copies Defaults to ~/.config/ with Automatic Backup](/omacom/omarchy/how-omarchy-refresh-config-copies-defaults-to-home-config-automatic-backup) Learn how omarchy-refresh-config copies defaults to ~/.config/ with automatic backups preserving your existing user files. - Tags: how-to-guide - Published: 2026-09-09 ### [How Hyprland Configuration Files Under config/hypr/ Are Structured and Loaded](/omacom/omarchy/how-hyprland-config-files-config-hypr-structured-loaded) Discover how Omarchy loads Hyprland configuration files. Explore the layered structure and Lua bootstrap system that customizes your desktop environment. - Tags: internals - Published: 2026-09-09 ### [How to Add a New Command Prefix to the Omarchy CLI Router with GROUP_DESCRIPTIONS](/omacom/omarchy/how-to-add-new-command-prefix-cli-router-group-descriptions) Learn to add a new command prefix to the Omarchy CLI router using GROUP_DESCRIPTIONS. Register your group and create executable scripts in bin/ to extend functionality. - Tags: how-to-guide - Published: 2026-09-09 ### [How the Menu Definition in `default/omarchy/omarchy-menu.jsonc` Works with Guards and Providers](/omacom/omarchy/how-menu-definition-default-omarchy-omarchy-menu-jsonc-works-guards-providers) Understand how the Omarchy menu definition in default/omarchy/omarchy-menu.jsonc uses guards and providers for dynamic, responsive menu systems that update without shell restarts. - Tags: internals - Published: 2026-09-09 ### [How the Hooks System in config/omarchy/hooks/ Triggers Lifecycle Events in Omarchy](/omacom/omarchy/how-hooks-system-config-omarchy-hooks-triggers-lifecycle-events) Discover how the Omarchy hooks system in config/omarchy/hooks/ triggers lifecycle events. Learn how it executes hook files and scripts for commands like omarchy theme set and omarchy update. - Tags: internals - Published: 2026-09-09 ### [How Shell Plugins in `shell/plugins/` Extend the Quickshell Desktop](/omacom/omarchy/how-shell-plugins-shell-plugins-extend-quickshell-desktop) Discover how Quickshell desktop integrates shell plugins from shell/plugins/ using JavaScript modules and shell.json. Extend functionality without core code changes. - Tags: internals - Published: 2026-09-09 ### [How the Two-Package Split Between Omarchy and Omarchy-Settings Is Organized](/omacom/omarchy/how-two-package-split-omarchy-omarchy-settings-organized) Discover how Omarchy organizes its two Arch Linux packages omarchy and omarchy-settings. Learn the separation of static defaults and runtime binaries for correct installation. - Tags: internals - Published: 2026-09-09 ### [How the Seed→Finalize→Resync Pattern Populates $HOME at Different Stages in Omarchy](/omacom/omarchy/how-seed-finalize-resync-pattern-populates-home-stages) Discover how the seed finalize resync pattern populates $HOME in Omarchy. Learn about skeleton files, runtime configs, and safe upgrades for your user data. - Tags: internals - Published: 2026-09-09 ### [How Omarchy Processes Theme .tpl Templates with {{ Variable }} Placeholders](/omacom/omarchy/how-theme-tpl-templates-processed-variable-placeholders) Discover how Omarchy processes theme .tpl templates using a sed-based engine to replace {{ variable }} placeholders with values from the colors.toml palette. - Tags: internals - Published: 2026-09-09 ### [How to Write a Migration Script in the Migrations/ Directory with the Timestamp Naming Convention](/omacom/omarchy/how-to-write-migration-script-migrations-timestamp-naming) Learn how to write a migration script in Omarchy's migrations directory using the timestamp naming convention. Follow these steps for effective database changes. - Tags: how-to-guide - Published: 2026-09-09 ### [How the Omarchy CLI Router Dispatches Commands to bin/omarchy-* Binaries](/omacom/omarchy/how-omarchy-cli-router-dispatches-commands-to-bin-omarchy-binaries) Discover how the Omarchy CLI router dispatches commands to bin/omarchy-* binaries. Learn about dynamic binary discovery, longest-prefix matching, and process replacement for efficient command execution. - Tags: internals - Published: 2026-09-09 ### [How the Omarchy Theme Activation Flow Works: A Complete Technical Breakdown](/omacom/omarchy/how-does-the-omarchy-theme-activation-flow-work) Discover the Omarchy theme activation flow. Our technical breakdown explains the 21-step Bash script process, including validation, file locking, and atomic directory swapping for seamless theme transitions. - Tags: deep-dive - Published: 2026-09-08 ### [Where Omarchy Themes Are Stored and How Theme Activation Works](/omacom/omarchy/where-are-omarchy-themes-stored-and-how-are-they-activated) Discover where Omarchy themes are stored in $OMARCHY_PATH/themes/ and ~/.config/omarchy/themes/. Learn how the omarchy-theme-set script activates themes and updates your Quickshell session. - Tags: how-to-guide - Published: 2026-09-08 ### [Complete Guide to Omarchy Shell IPC Commands: API Reference and Examples](/omacom/omarchy/what-are-the-available-ipc-commands-for-interacting-with-the-omarchy-shell) Master Omarchy shell IPC commands. Control plugins, manage widgets, and reload config with this comprehensive API reference and examples. Explore summon, toggle, and reloadConfig. - Tags: api-reference - Published: 2026-09-08 ### [How Quickshell Desktop is Configured Using shell.json in Omarchy](/omacom/omarchy/how-is-the-quickshell-desktop-configured-using-shell.json) Configure Quickshell desktop using shell.json in Omarchy. Define idle timers, panel position, and widget layouts through a JSON schema without code changes. - Tags: how-to-guide - Published: 2026-09-08 ### [How Omarchy Installs and Manages Third-Party Plugins: The Complete Guide](/omacom/omarchy/how-are-third-party-plugins-installed-and-managed-in-omarchy) Learn how Omarchy installs and manages third-party plugins using Git repositories and CLI commands. This complete guide details the process for the omacom/omarchy project. - Tags: how-to-guide - Published: 2026-09-08 ### [Quickshell Plugin Kinds Explained: The Complete Architecture Guide for Omarchy](/omacom/omarchy/what-are-the-different-plugin-kinds-available-in-quickshell) Explore the fourteen Quickshell plugin kinds like service panel bar and more. Understand how each kind integrates into the Omarchy shell architecture for custom user interfaces. - Tags: architecture - Published: 2026-09-08 ### [How the Quickshell Desktop Is Launched and Restarted in Omarchy](/omacom/omarchy/how-is-the-quickshell-desktop-launched-and-restarted-in-omarchy) Discover how Omarchy launches and restarts the Quickshell desktop using the omarchy-launch-shell script. Learn about supervised processes, automatic restarts, and systemd journal logging. - Tags: internals - Published: 2026-09-08 ### [What Is Dev-Link Mode in Omarchy? A Complete Development Workflow Guide](/omacom/omarchy/what-is-dev-link-mode-in-omarchy-and-how-is-it-used-for-development) Discover Omarchy's dev-link mode for instant local testing. This guide explains how to redirect the runtime to your checkout without reinstallation, streamlining your development workflow. - Tags: how-to-guide - Published: 2026-09-08 ### [How omarchy update Works in Omarchy: A Deep Dive into the System Update Orchestrator](/omacom/omarchy/how-does-omarchy-update-work-in-omarchy) Discover how omarchy update performs safe, unattended system upgrades in Omarchy. Learn about its 14-step pipeline, file locking, and automatic conflict resolution. - Tags: deep-dive - Published: 2026-09-08 ### [Essential Omarchy CLI Commands and Their Purposes](/omacom/omarchy/what-are-the-essential-omarchy-cli-commands-and-their-purposes) Master essential Omarchy CLI commands for system updates theme management hardware toggles and diagnostics Discover powerful tools in this unified interface - Tags: how-to-guide - Published: 2026-09-08 ### [How Omarchy Stores and Reads Command Metadata: Inside the Bash-Based Discovery System](/omacom/omarchy/how-is-command-metadata-stored-and-read-in-omarchy) Discover how Omarchy stores command metadata using structured comments in Bash scripts. Learn how the system parses key-value pairs for efficient command discovery. - Tags: internals - Published: 2026-09-08 ### [How Omarchy Handles Command Aliases and Metadata-Moved Routes: A Deep Dive into the CLI Router](/omacom/omarchy/how-does-omarchy-handle-command-aliases-and-metadata-moved-routes) Discover how Omarchy handles command aliases and metadata-moved routes. Learn about its efficient CLI router design for fast command resolution. - Tags: deep-dive - Published: 2026-09-08 ### [Omarchy Fallback Path Resolution Strategy: How Commands Locate Files](/omacom/omarchy/what-is-the-fallback-path-resolution-strategy-for-omarchy-commands) Discover Omarchy's fallback path resolution strategy. Learn how commands find files using OMARCHY_PATH or the system directory for efficient command execution. - Tags: internals - Published: 2026-09-08 ### [Omarchy Fast Path Resolution Strategy: How Commands Are Resolved Without Metadata](/omacom/omarchy/what-is-the-fast-path-resolution-strategy-for-omarchy-commands) Discover Omarchy's fast path resolution strategy. Learn how commands resolve instantly by probing the filesystem for executables before metadata loading. - Tags: internals - Published: 2026-09-08 ### [How Omarchy Manages the PATH Environment Variable and mise Shims](/omacom/omarchy/how-does-omarchy-manage-the-path-environment-variable-including-mise-shims) Learn how Omarchy deterministically manages the PATH environment variable. Discover how it injects mise shims and user bins for consistent tool resolution. - Tags: internals - Published: 2026-09-08 ### [What Is OMARCHY_PATH and How Is It Determined in the Omarchy Desktop Environment?](/omacom/omarchy/what-is-omarchy_path-and-how-is-it-determined) Learn what OMARCHY_PATH is and how it's set in the Omarchy desktop environment. Discover its role in specifying active Omarchy checkout paths for seamless development. - Tags: how-to-guide - Published: 2026-09-08 ### [How Omarchy Bootstraps Its Runtime Environment: A Deep Dive into the Lua Module Path and Environment Setup](/omacom/omarchy/how-does-omarchy-bootstrap-its-runtime-environment) Learn how Omarchy bootstraps its runtime by customizing the Lua module path for user state, overrides, and default modules. Explore environment setup in this deep dive. - Tags: deep-dive - Published: 2026-09-08 ### [The Role of /etc/skel/ in Omarchy User Creation](/omacom/omarchy/what-is-the-role-of-etc-skel-in-omarchy-user-creation) Discover how /etc/skel/ in Omarchy seeds new user accounts with essential default files and configurations. Learn its crucial role in streamlined user creation. - Tags: internals - Published: 2026-09-08 ### [What Is the omarchy-settings Package in Omarchy? Purpose and Implementation](/omacom/omarchy/what-is-the-purpose-of-the-omarchy-settings-package-in-omarchy) Discover the omarchy-settings package in Omarchy. Learn how it provides static assets, default configs, and templates for safe updates using omarchy-refresh-config. - Tags: deep-dive - Published: 2026-09-08 ### [What Is the Purpose of the Omarchy Package in Omarchy?](/omacom/omarchy/what-is-the-purpose-of-the-omarchy-package-in-omarchy) Discover the Omarchy package, the core of the Omarchy Linux distribution. It unites scripts, QML components, and config files for an agentic desktop experience. - Tags: deep-dive - Published: 2026-09-08 ### [How Omarchy Is Structured as Arch Linux Packages: The Two-Package System Explained](/omacom/omarchy/how-is-omarchy-structured-as-arch-linux-packages) Understand Omarchy's Arch Linux packages structure. Discover how the omarchy and omarchy-settings packages manage runtime and configurations using pacman for dependencies and updates. - Tags: internals - Published: 2026-09-08 ### [How `omarchy-hw-asus-rog` Returns Exit Codes in Omarchy](/omacom/omarchy/how-does-omarchy-hw-asus-rog-return-exit-codes) Learn how omarchy-hw-asus-rog returns exit codes in Omarchy. Understand exit codes 0, 1, and errors for ROG hardware detection. - Tags: how-to-guide - Published: 2026-09-06 ### [How Wi‑Fi QR Code Sharing Works with LocalSend in Omarchy: A Deep Dive into Network-to-Device Handoff](/omacom/omarchy/how-does-wi-fi-qr-code-sharing-work-with-localsend) Discover how Omarchy enables seamless Wi-Fi QR code sharing with LocalSend. Learn how this innovative network-to-device handoff simplifies secure connections. - Tags: deep-dive - Published: 2026-09-06 ### [How omarchy-migrate-notify.service Detects Pending Migrations in Omarchy](/omacom/omarchy/how-does-omarchy-migrate-notify-service-detect-pending-migrations) Discover how omarchy-migrate-notify.service detects pending migrations by checking lock files and querying outstanding migrations with omarchy-migrate. - Tags: how-to-guide - Published: 2026-09-06 ### [How `omarchy-plymouth-set-by-theme` Generates Boot Screens: A Deep Source Code Analysis](/omacom/omarchy/how-does-omarchy-plymouth-set-by-theme-generate-boot-screens) Discover how omarchy-plymouth-set-by-theme generates boot screens. This analysis dives into source code, revealing how it transforms Omarchy themes into Plymouth splashes. - Tags: deep-dive - Published: 2026-09-06 ### [How omarchy-default-agent Integrates with XDG Defaults: A Complete Technical Guide](/omacom/omarchy/how-does-omarchy-default-agent-wire-into-xdg-defaults) Learn how omarchy-default-agent integrates with XDG defaults. Discover how it stores and exposes your default agent for seamless system integration. Get the complete technical guide. - Tags: how-to-guide - Published: 2026-09-06 ### [How omarchy‑refresh‑config Copies Defaults with Backup in Omarchy](/omacom/omarchy/how-does-omarchy-refresh-config-copy-defaults-with-backup) Discover how omarchy-refresh-config safely synchronizes user configs with defaults. It preserves customizations by creating timestamped backups, ensuring your settings are never lost. - Tags: how-to-guide - Published: 2026-09-06 ### [How the Omarchy Menu's `checked` Field Wires to Shell Conditions](/omacom/omarchy/how-does-menus-checked-field-wire-to-shell-conditions) Learn how the Omarchy menu's checked field wires to shell conditions. Discover how Bash expressions determine menu item visibility and state. - Tags: internals - Published: 2026-09-06 ### [How omarchy‑dev‑link Maintains Sudo Access for Local Development](/omacom/omarchy/how-does-omarchy-dev-link-maintain-sudo-access) omarchy-dev-link maintains sudo access for local development by prepending your bin directory to sudo secure_path. Resolve privileged commands to your dev binaries easily. - Tags: how-to-guide - Published: 2026-09-06 ### [Difference Between omarchy and omarchy-settings Packages](/omacom/omarchy/difference-between-omarchy-and-omarchy-settings-packages) Understand the core difference between omarchy and omarchy-settings packages. Learn how runtime code and default configurations work together in the omarchy desktop environment. - Tags: deep-dive - Published: 2026-09-06 ### [How `omarchy-provision-user` Sets Up Skill Symlinks: Complete Walkthrough](/omacom/omarchy/how-does-omarchy-provision-user-set-up-skill-symlinks) Discover how omarchy-provision-user sets up skill symlinks in your home directory, granting direct access to Omarchy helper commands without file copying or path changes. - Tags: how-to-guide - Published: 2026-09-06 ### [Idempotency Guarantees for Omarchy Migrations: How Safe Execution Works](/omacom/omarchy/what-idempotency-guarantees-exist-for-omarchy-migrations) Discover Omarchy migrations' idempotency guarantees: safe execution via marker files, early-exit checks, atomic changes, and failure-safe queue processing. Learn how Omarchy ensures reliable data migrations. - Tags: internals - Published: 2026-09-06 ### [How Omarchy Migrations Run Per‑User: Complete Technical Guide](/omacom/omarchy/how-do-omarchy-migrations-run-per-user) Discover how Omarchy migrations run per-user by storing markers in user home directories and executing scripts under the invoking user's UID for granular privilege escalation. - Tags: technical-guide - Published: 2026-09-06 ### [How `--defer-provisioning` Creates Users on First Boot in Omarchy](/omacom/omarchy/how-does-defer-provisioning-create-users-on-first-boot) Learn how Omarchy's --defer-provisioning creates users on first boot. Discover how it defers user creation until system startup for efficient deployment. - Tags: internals - Published: 2026-09-06 ### [Omarchy Menu Provider System: How Dynamic Menu Generation Works](/omacom/omarchy/what-is-the-omarchy-menu-provider-system) Explore the Omarchy menu provider system, a runtime extension that dynamically generates submenu items using JavaScript modules. Learn how it works with static JSON-C definitions. - Tags: internals - Published: 2026-09-06 ### [How omarchy-menu.jsonc Defines Menu Entries with Shell Conditions](/omacom/omarchy/how-does-omarchy-menu-jsonc-define-menu-entries-with-shell-conditions) Learn how omarchy-menu.jsonc conditionally renders menu entries using shell conditions with when checked and disabled fields. Explore exit codes and test expressions. - Tags: how-to-guide - Published: 2026-09-06 ### [How Quickshell Desktop Integrates with Hyprland: A Deep Dive Into Omacom/Omarchy](/omacom/omarchy/how-does-quickshell-desktop-integrate-with-hyprland) Discover how Quickshell integrates with Hyprland using its QML module. Learn how it exposes compositor state and forwards events for seamless desktop experience. - Tags: deep-dive - Published: 2026-09-06 ### [How Omarchy Detects Route Collisions with `omarchy commands --check`](/omacom/omarchy/how-are-route-collisions-detected-by-omarchy-commands-check) Learn how omarchy commands --check detects route collisions by mapping command routes at runtime and flagging duplicate entries. Prevent conflicts in your binaries. - Tags: how-to-guide - Published: 2026-09-06 ### [How omarchy Handles `--help` Flag Anywhere in Arguments](/omacom/omarchy/how-does-omarchy-handle-help-flag-anywhere-in-arguments) Discover how omarchy handles the --help flag anywhere in arguments. Learn how omarchy's CLI router displays help for resolved routes instantly. - Tags: internals - Published: 2026-09-06 ### [How Omarchy Command Metadata Comments Influence CLI Routing: A Complete Guide](/omacom/omarchy/how-do-omarchy-command-metadata-comments-influence-routing) Discover how omarchy command metadata comments drive CLI routing. Learn how these comments auto-generate the routing table to map commands to scripts, simplifying your workflow. - Tags: deep-dive - Published: 2026-09-06 ### [How Omarchy's Fast Path Bypasses Metadata Parsing for Instant CLI Dispatch](/omacom/omarchy/how-does-omarchy-fast-path-bypass-metadata-parsing) Omarchy's fast path bypasses metadata parsing using stat calls for instant CLI dispatch. Execute matching binaries immediately without reading file contents. - Tags: internals - Published: 2026-09-06 ### [Omarchy Longest-Prefix Dispatch Algorithm: How the CLI Router Resolves Commands](/omacom/omarchy/what-is-the-longest-prefix-dispatch-algorithm-in-omarchy) Discover Omarchy's longest-prefix dispatch algorithm. Learn how the CLI router intelligently matches your commands for efficient execution. Optimize your terminal workflow today. - Tags: internals - Published: 2026-09-06 ### [How the Omarchy CLI Router Maps Commands to Bin Binaries: A Deep Dive into Dynamic Routing](/omacom/omarchy/how-does-omarchy-cli-router-map-commands-to-bin-binaries) Discover how the Omarchy CLI router maps commands to bin binaries by parsing executable metadata and building a dynamic routing table for efficient command dispatch. Learn the two-stage resolution process. - Tags: deep-dive - Published: 2026-09-06 ### [How to Install Packages (Including AUR) Using Omarchy’s Helper Commands](/omacom/omarchy/how-do-i-install-packages-including-aur-using-omarchys-helper-commands) Easily install packages from official Arch repositories and the AUR using Omarchy's unified `omarchy-pkg-add` command. Simplify your workflow today. - Tags: how-to-guide - Published: 2026-09-05 ### [How Omarchy Notifies Users About Pending Migrations: Systemd Service and Desktop Alerts Explained](/omacom/omarchy/how-does-omarchy-notify-users-about-pending-migrations) Learn how Omarchy notifies users about pending migrations using systemd services and desktop alerts. Get timely updates for your Omarchy system. - Tags: how-to-guide - Published: 2026-09-05 ### [Omarchy Migration Scripts: Location and Execution Guide](/omacom/omarchy/where-are-omarchy-migration-scripts-located-and-how-are-they-executed) Find Omarchy migration scripts in the migrations directory and learn how to execute them with the omarchy-migrate command. Track progress effortlessly. - Tags: how-to-guide - Published: 2026-09-05 ### [How Omarchy Handles Database Migrations: A Complete Guide to Script-Driven System Evolution](/omacom/omarchy/how-does-omarchy-handle-database-migrations) Omarchy streamlines database migrations with a script-driven system. Discover and execute timestamped SQL scripts easily and ensure atomic updates for robust system evolution. Learn how. - Tags: how-to-guide - Published: 2026-09-05 ### [Understanding Omarchy Theme Components: Colors and Typography Explained](/omacom/omarchy/what-are-the-components-of-an-omarchy-theme-colors-typography) Explore Omarchy theme components including colors and typography. Learn how colors.toml and font configurations create stunning interfaces in the Omarchy theme. - Tags: deep-dive - Published: 2026-09-05 ### [How to Apply a Theme in Omarchy: Complete CLI Guide](/omacom/omarchy/how-do-i-apply-a-theme-in-omarchy) Apply a theme in Omarchy using the command line. Switch color palettes for Hyprland, Quickshell, and GTK/Qt apps instantly with the omarchy-theme-apply command. - Tags: how-to-guide - Published: 2026-09-05 ### [How External Tools Communicate with the Omarchy Shell via IPC](/omacom/omarchy/how-can-external-tools-communicate-with-the-omarchy-shell-via-ipc) Learn how external tools communicate with the Omarchy Shell via IPC using Unix domain sockets and JSON-RPC. Integrate seamlessly with the omarchy-shell CLI or direct connections. - Tags: internals - Published: 2026-09-05 ### [How the Omarchy Plugin System Works: MenuModel Architecture Explained](/omacom/omarchy/how-does-the-omarchy-plugin-system-work) Explore the Omarchy plugin system and its MenuModel architecture. Learn how plugins inject menu entries without mutating global state using swapProviderRows. - Tags: internals - Published: 2026-09-05 ### [What Is the Omarchy Shell? Architecture, Configuration, and Plugin System](/omacom/omarchy/what-is-the-omarchy-shell-and-how-is-it-configured) Discover the Omarchy Shell, a unified Quickshell process for the Omarchy desktop. Learn its architecture, central JSON configuration, and dynamic plugin system. - Tags: deep-dive - Published: 2026-09-05 ### [How to Apply System Configurations in Omarchy: Using the `omarchy-refresh-config` Helper](/omacom/omarchy/how-do-i-apply-system-configurations-in-omarchy) Easily apply Omarchy system configurations using omarchy-refresh-config. Safely update your user directory with automatic backups for your customizations. - Tags: how-to-guide - Published: 2026-09-05 ### [How to Install Optional Software with Omarchy: The Complete Guide](/omacom/omarchy/how-do-i-install-optional-software-with-omarchy) Easily install optional software with Omarchy using the omarchy install command. Manage packages without pacman or yay privileges. Get the complete guide now. - Tags: how-to-guide - Published: 2026-09-05 ### [How to Manage Themes in Omarchy: A Complete Guide to CLI Tools and Configuration](/omacom/omarchy/how-do-i-manage-themes-in-omarchy) Learn to manage Omarchy themes effortlessly using CLI tools and configuration. Our guide covers installation, switching, and refreshing themes with ease. - Tags: how-to-guide - Published: 2026-09-05 ### [How to Toggle Features On or Off in Omarchy: A Complete Guide to the Flag-File System](/omacom/omarchy/how-do-i-toggle-features-on-or-off-in-omarchy) Learn how to toggle features on or off in Omarchy using its flag-file system. This guide explains the simple commands to enable, disable, and manage your Omarchy features easily. - Tags: how-to-guide - Published: 2026-09-05 ### [How to Refresh User Configurations to Default Settings in Omarchy](/omacom/omarchy/how-can-i-refresh-user-configurations-to-default-settings-in-omarchy) Easily refresh user configurations to default settings in Omarchy using the omarchy-refresh-config utility. Automatically back up existing files before restoring defaults. - Tags: how-to-guide - Published: 2026-09-05 ### [How Omarchy Detects Hardware: A Deep Dive Into Its Predicate-Based Detection System](/omacom/omarchy/how-does-omarchy-detect-hardware) Discover how Omarchy detects hardware using a predicate-based system of lightweight bash scripts. Learn about its fast, dependency-free detection for menus, hooks, and plugins. - Tags: deep-dive - Published: 2026-09-05 ### [Omarchy CLI Commands for Package Management: A Complete Guide](/omacom/omarchy/what-are-the-omarchy-cli-commands-for-package-management) Master Omarchy CLI commands for package management. Discover eight pkg subcommands offering safe, idempotent Arch Linux installs and unified help. - Tags: how-to-guide - Published: 2026-09-05 ### [How to Check If a Command Exists in Omarchy: A Complete Guide to `omarchy-cmd-present` and `omarchy-cmd-missing`](/omacom/omarchy/how-do-i-check-if-a-command-exists-in-omarchy) Easily check if a command exists in Omarchy using `omarchy-cmd-present` and `omarchy-cmd-missing`. Get reliable exit codes for scripts migrations and tests. - Tags: how-to-guide - Published: 2026-09-05 ### [What Is the Main CLI Router for Omarchy Commands? Understanding bin/omarchy](/omacom/omarchy/what-is-the-main-cli-router-for-omarchy-commands) Discover bin/omarchy, the main CLI router for Omarchy commands. Learn how it parses input and directs execution to sub-commands for efficient management. - Tags: internals - Published: 2026-09-05 ### [How Omarchy Manages System and Runtime Binaries: A Metadata‑Driven Command System](/omacom/omarchy/how-does-omarchy-manage-system-and-runtime-binaries) Discover how Omarchy manages system and runtime binaries with a metadata-driven command system. Learn about its single dispatcher script for efficient binary management. - Tags: internals - Published: 2026-09-05 ### [What Is the Purpose of the `omarchy-settings` Package?](/omacom/omarchy/what-is-the-purpose-of-the-omarchy-settings-package) Discover the purpose of the omarchy-settings package. Learn how it centralizes Omarchy configuration, defines schemas, loads overrides, and provides settings to other components. - Tags: how-to-guide - Published: 2026-09-05 ### [What Are the Three Layers of Provisioning in Omarchy?](/omacom/omarchy/what-are-the-three-layers-of-provisioning-in-omarchy) Discover Omarchy's three provisioning layers: Seed, Finalize, and Resync. Learn how these layers manage user home directory configuration effectively. - Tags: deep-dive - Published: 2026-09-05 ### [How Omarchy Handles User Configuration and System Defaults: A Complete Guide](/omacom/omarchy/how-does-omarchy-handle-user-configuration-and-system-defaults) Learn how Omarchy handles user configuration and system defaults. Discover how the omarchy-refresh-config command syncs settings while preserving your customizations. - Tags: how-to-guide - Published: 2026-09-05 ### [Where Are Omarchy Migration Completion Markers Stored? A Complete Guide](/omacom/omarchy/where-are-omarchy-migration-completion-markers-stored) Discover where Omarchy stores migration completion markers. Learn about the default path /var/lib/omarchy/migrations/ and how to customize it via environment variables. - Tags: how-to-guide - Published: 2026-09-04 ### [How Security Filters Are Applied to Omarchy Themes](/omacom/omarchy/how-are-security-filters-applied-to-omarchy-themes) Learn how Omarchy applies security filters to themes from Git repos. Discover how executable files, symlinks, and terminal configs are blocked during staging. - Tags: how-to-guide - Published: 2026-09-04 ### [How to Use Color Blending in Omarchy Templates: A Complete Guide](/omacom/omarchy/how-to-use-color-blending-in-omarchy-templates) Master color blending in Omarchy templates with our guide. Learn to use Hyprland and CSS color-mix functions with theme variables for dynamic designs. - Tags: how-to-guide - Published: 2026-09-04 ### [How the Omarchy Theming Pipeline Generates Configuration Files](/omacom/omarchy/how-does-omarchy-theming-pipeline-generate-configs) Learn how the Omarchy theming pipeline generates configuration files by staging themes, overlaying customizations, and rendering TOML templates with atomic activation. - Tags: internals - Published: 2026-09-04 ### [How Omarchy Determines Its Type Scale: Base Size and Multiplier Architecture](/omacom/omarchy/how-is-type-scale-determined-in-omarchy) Discover how Omarchy establishes its type scale using a base font size and fixed multipliers for a consistent visual hierarchy. Learn about its Style.font tokens. - Tags: architecture - Published: 2026-09-04 ### [The Omarchy Style Token System: Centralized QML Theming Architecture](/omacom/omarchy/what-is-style-token-system-in-omarchy) Discover the Omarchy Style token system a centralized QML singleton for dynamic theming. Easily manage colors spacing typography and dimensions with runtime overrides via shell.toml. - Tags: architecture - Published: 2026-09-04 ### [How the Color Singleton Works in Omarchy QML: A Deep Dive into Theme-Aware Colors](/omacom/omarchy/how-does-color-singleton-work-in-omarchy-qml) Explore the Color singleton in Omarchy QML. Learn how this pragma Singleton centralizes reactive, theme-aware colors that automatically update with configuration changes. - Tags: deep-dive - Published: 2026-09-04 ### [Where Are Omarchy Theme Colors Defined? A Complete Guide to the Theming System](/omacom/omarchy/where-are-omarchy-theme-colors-defined) Discover where Omarchy theme colors are defined within the `themes//colors.toml` files. Learn how these colors configure your shell, terminal, and UI. - Tags: how-to-guide - Published: 2026-09-04 ### [How Omarchy Plugins Are Updated: The Git-Based Hot-Reload System](/omacom/omarchy/how-are-omarchy-plugins-updated) Discover how Omarchy plugins update using a Git hot-reload system. Fetch changes, review diffs, and seamlessly update your shell without a full restart. - Tags: internals - Published: 2026-09-04 ### [How to Add Third-Party Plugins to Omarchy: CLI and Manual Methods](/omacom/omarchy/how-to-add-third-party-plugins-to-omarchy) Easily add third-party plugins to Omarchy using CLI or manual methods. Learn how to install and manage plugins for enhanced functionality. - Tags: how-to-guide - Published: 2026-09-04 ### [Omarchy Quickshell IPC Targets: Complete Guide to Inter-Process Communication](/omacom/omarchy/what-are-ipc-targets-for-omarchy-quickshell) Explore Omarchy Quickshell IPC targets. Learn how Omarchy communicates with Quickshell via five key IPC targets using the qs ipc command for efficient inter-process communication. - Tags: deep-dive - Published: 2026-09-04 ### [How to Configure Omarchy Shell Plugin Settings: JSON Persistence and QML Integration](/omacom/omarchy/how-are-omarchy-shell-plugin-settings-configured) Configure omarchy shell plugin settings using JSON files in $HOME/.local/state/omarchy/settings. Learn how settings are injected into QML components and persisted automatically. - Tags: how-to-guide - Published: 2026-09-04 ### [How the Active Bar Is Determined in Omarchy's shell.json](/omacom/omarchy/how-is-active-bar-determined-in-omarchy-shell-json) Discover how Omarchy's shell.json determines the active bar at runtime by matching focused monitors with screen names using the pickPanelSlot function. - Tags: internals - Published: 2026-09-04 ### [How Plugins Declare Themselves in Omarchy’s Quickshell: The Complete Manifest Guide](/omacom/omarchy/how-do-plugins-declare-themselves-in-omarchy-quickshell) Learn how plugins declare themselves in Omarchy's Quickshell by creating a manifest.json file. This guide details the validation and registration process for a seamless experience. - Tags: how-to-guide - Published: 2026-09-04 ### [How the Quickshell Desktop in Omarchy Works: Architecture and Plugin System](/omacom/omarchy/how-does-quickshell-desktop-in-omarchy-work) Explore the Quickshell desktop in Omarchy. Discover its modular QML architecture, dynamic plugin system for bars and widgets, and JSON configuration. - Tags: architecture - Published: 2026-09-04 ### [Where Are Omarchy Group Descriptions Stored? A Deep Dive into the Core Dispatcher](/omacom/omarchy/where-are-omarchy-group-descriptions-stored) Discover where omarchy group descriptions are stored. This guide reveals the exact location within the core dispatcher script for easy access and management. - Tags: deep-dive - Published: 2026-09-04 ### [How Hidden Commands Are Managed in Omarchy: Metadata Parsing and Filtering Explained](/omacom/omarchy/how-are-hidden-commands-managed-in-omarchy) Discover how Omarchy manages hidden commands by parsing metadata and filtering entries. Learn to reveal all commands with the --all flag. - Tags: internals - Published: 2026-09-04 ### [How to Check for Omarchy Command Route Collisions: Validation and Detection Guide](/omacom/omarchy/how-to-check-for-omarchy-command-route-collisions) Discover how to check for omarchy command route collisions using `omarchy commands --check`. Detect conflicting command paths and ensure routing integrity with this essential guide. - Tags: how-to-guide - Published: 2026-09-04 ### [Metadata Schema for Omarchy Commands: Complete CLI Routing Guide](/omacom/omarchy/what-is-metadata-schema-for-omarchy-commands) Explore the Omarchy CLI metadata schema. Learn how Bash commands define routing permissions and documentation using # omarchy: comment directives. Your complete CLI routing guide. - Tags: architecture - Published: 2026-09-04 ### [How the Omarchy CLI Router Resolves Subcommands: Inside bin/omarchy](/omacom/omarchy/how-does-omarchy-cli-router-resolve-subcommands) Learn how the omarchy CLI router resolves subcommands via discovery registration longest prefix matching and fallback resolution Understand the inner workings of bin omarchy - Tags: internals - Published: 2026-09-04 ### [How Omarchy Manages sudo secure_path for Isolated Privilege Escalation](/omacom/omarchy/how-omarchy-manage-sudo-secure-path) Discover how Omarchy manages sudo secure_path using a custom sudoers fragment. Learn to restrict privileged execution to trusted directories for enhanced security. - Tags: how-to-guide - Published: 2026-09-03 ### [How to Manage OMARCHY_PATH in Omarchy Development: Complete Environment Setup Guide](/omacom/omarchy/how-to-manage-omarchy-path-development) Master OMARCHY_PATH in Omarchy development. This guide details environment setup and resource management for the omacom/omarchy repository. Learn to configure OMARCHY_PATH effectively. - Tags: how-to-guide - Published: 2026-09-03 ### [What Is the Omarchy-Dev-Link Workflow? A Complete Developer's Guide](/omacom/omarchy/what-is-omarchy-dev-link-workflow) Master the omarchy-dev-link workflow a developer helper that re-targets Omarchy runtime to your local checkout for efficient development. Learn how it works. - Tags: deep-dive - Published: 2026-09-03 ### [How Omarchy Handles AUR Packages: Command Architecture and Helper Integration](/omacom/omarchy/how-omarchy-handle-aur-packages) Omarchy seamlessly manages AUR packages with wrapper commands, integrating with helpers like yay and paru for consistent installation, updates, and migration. - Tags: architecture - Published: 2026-09-03 ### [How to Drop Packages Using `omarchy-pkg-drop` in Omarchy](/omacom/omarchy/how-to-drop-packages-omarchy-pkg-drop) Safely remove packages with omarchy-pkg-drop a Pacman wrapper that handles virtual providers orphaned dependencies and privilege escalation. Learn how to drop packages efficiently. - Tags: how-to-guide - Published: 2026-09-03 ### [Omarchy Hardware Detection Patterns: Shell-Based System Identification](/omacom/omarchy/omarchy-hardware-detection-patterns) Discover Omarchy hardware detection patterns. Learn how Omarchy uses shell scripts and standard Linux utilities like lspci and lsusb to identify system components. - Tags: how-to-guide - Published: 2026-09-03 ### [How Omarchy Integrates Color and Style Singletons for Theme-Consistent UI](/omacom/omarchy/how-omarchy-integrate-color-style-singletons) Discover how Omarchy integrates Color and Style singletons to ensure theme consistency across your UI. Learn about their single source of truth for design tokens. - Tags: internals - Published: 2026-09-03 ### [How to Use the BorderSurface QML API in Omarchy](/omacom/omarchy/how-to-use-bordersurface-qml-api-omarchy) Learn to use the BorderSurface QML API in Omarchy. Render native borders or complex gradients with the borderSpec property for optimized visuals. - Tags: how-to-guide - Published: 2026-09-03 ### [Quickshell Desktop Configuration (shell.json) Structure in Omarchy: Complete Guide](/omacom/omarchy/quickshell-desktop-configuration-shell-json-structure) Explore the Quickshell desktop configuration shell.json structure in Omarchy. Understand status bar layout, plugins, and global settings for your Quickshell environment. Get the complete guide. - Tags: how-to-guide - Published: 2026-09-03 ### [Understanding post_theme_commands in Omarchy: Automating Post-Activation Hooks](/omacom/omarchy/what-are-omarchy-post-theme-commands) Discover post_theme_commands in Omarchy to automate post-activation hooks. Learn how these JSON-C hooks run shell commands after theme assets apply, enabling immediate service restarts like Waybar. - Tags: internals - Published: 2026-09-03 ### [How Omarchy Filters User Theme Overlays: A Technical Deep Dive](/omacom/omarchy/how-omarchy-filter-user-theme-overlays) Discover how Omarchy filters user theme overlays using a two-step system. Learn about full file replacement for manual themes and security denylists for Git-cloned themes, blocking executable config files. - Tags: deep-dive - Published: 2026-09-03 ### [Omarchy Theme Activation Flow: How the 11-Step Process Works](/omacom/omarchy/omarchy-theme-activation-flow-description) Discover the Omarchy theme activation flow. Learn how this 11-step process stages, renders, and atomically swaps themes, updating your shell instantly. - Tags: how-to-guide - Published: 2026-09-03 ### [How Omarchy Explicitly Resyncs Clamshell Display State: System-Wake Deep Dive](/omacom/omarchy/how-omarchy-handle-explicit-resync) Learn how Omarchy explicitly resyncs clamshell display state with the system wake command. Restore brightness and reconcile monitor configuration with hardware state. - Tags: deep-dive - Published: 2026-09-03 ### [Runtime Finalization with `omarchy-provision-user`: How Omarchy Prepares User Environments](/omacom/omarchy/omarchy-runtime-finalization-omarchy-provision-user) Learn about runtime finalization with omarchy-provision-user. Omarchy prepares user environments efficiently using idempotency markers and supports forced re-runs with the --force flag. - Tags: how-to-guide - Published: 2026-09-03 ### [How Omarchy Seeds New Users' Home Directories Using `/etc/skel`](/omacom/omarchy/omarchy-file-layout-etc-skel-new-users) Omarchy seeds new users' home directories using /etc/skel. Discover how the omarchy-settings package automatically configures new user environments for a seamless setup. - Tags: how-to-guide - Published: 2026-09-03 ### [How to Configure Hyprland Theme Templates in Omarchy: A Complete Guide for Customizing Your Desktop](/omacom/omarchy/how-to-configure-hyprland-theme-templates-omarchy) Learn how to configure Hyprland theme templates in Omarchy. This guide explains using *.tpl files and colors.toml to generate custom Hyprland configurations. Master your desktop appearance. - Tags: how-to-guide - Published: 2026-09-03 ### [Shell.toml Surface Roles in Omarchy: Complete Guide to UI Styling Tokens](/omacom/omarchy/omarchy-shell-toml-surface-roles) Explore shell.toml surface roles in Omarchy, a guide to UI styling tokens. Learn how Omarchy's named style token groups define visual elements for your interface. - Tags: tutorial - Published: 2026-09-03 ### [How Themes Are Rendered in Omarchy: Complete Technical Guide](/omacom/omarchy/how-omarchy-theme-rendering) Discover how Omarchy renders themes at runtime using a QML architecture. Learn how Color.qml and Style.qml parse TOML for instant UI updates. - Tags: deep-dive - Published: 2026-09-03 ### [How Omarchy Uses `colors.toml` Palette Keys for Unified System Theming](/omacom/omarchy/omarchy-colors-toml-palette-keys) Discover how Omarchy leverages colors.toml palette keys as the single source of truth for unified system theming across terminal emulators, shell UI, editors, browsers, and compositor configurations. - Tags: how-to-guide - Published: 2026-09-03 ### [Omarchy Theming Architecture Components: A Complete Technical Guide](/omacom/omarchy/omarchy-theming-architecture-components) Explore Omarchy's theming architecture components including theme directories, color palettes, template files, and runtime hooks to create unified desktop themes. - Tags: architecture - Published: 2026-09-03 ### [How to Create a New Migration Script in Omarchy: A Complete Guide](/omacom/omarchy/how-to-create-omarchy-migration-script) Learn how to create a new migration script in Omarchy with this guide. Scaffold and implement idempotent shell commands efficiently. - Tags: how-to-guide - Published: 2026-09-03 ### [Omarchy Two-Pass Dispatch: How the CLI Router Resolves Commands](/omacom/omarchy/omarchy-cli-router-two-pass-dispatch) Understand Omarchy's two-pass dispatch CLI router. It prioritizes exact filename matches and uses metadata resolution as a fallback for efficient command routing. - Tags: internals - Published: 2026-09-03 ### [How Omarchy's CLI Router Handles Longest-Prefix Matching](/omacom/omarchy/how-omarchy-cli-router-longest-prefix-matching) Discover how Omarchy's CLI router performs longest-prefix matching to efficiently resolve commands. Learn about its argument matching and fallback logic for precise command execution. - Tags: internals - Published: 2026-09-03 ### [How to Add, Update, and Remove Plugins in Omarchy: Complete CLI Guide](/omacom/omarchy/how-do-i-add-update-or-remove-plugins-in-omarchy) Easily add update and remove Omarchy plugins using the CLI. Learn commands like omarchy plugin add and explore options for automated management. - Tags: how-to-guide - Published: 2026-09-02 ### [How the Quickshell Plugin System Works in Omarchy: A Deep Dive into Manifest-Based Extension Architecture](/omacom/omarchy/what-is-the-plugin-system-for-quickshell) Discover Quickshell's manifest-driven plugin system in Omarchy. Learn how extensions declare capabilities and integrate seamlessly into the shell via widgets, panels, and more. - Tags: deep-dive - Published: 2026-09-02 ### [How CLIs Communicate with a Running Quickshell Instance: The Complete IPC Breakdown](/omacom/omarchy/how-do-clis-communicate-with-the-running-quickshell-instance) Learn how omarchy CLIs communicate with Quickshell using Unix-domain sockets and the qs ipc subcommand for seamless Inter-Process Communication. Explore the complete IPC breakdown. - Tags: deep-dive - Published: 2026-09-02 ### [How Omarchy Launches and Restarts Its Desktop Shell: Complete Technical Guide](/omacom/omarchy/how-is-the-omarchy-desktop-shell-launched-and-restarted) Learn how Omarchy launches and restarts its desktop shell using a bin/omarchy-shell wrapper script. Discover full restarts and lightweight config reloads. - Tags: deep-dive - Published: 2026-09-02 ### [How to Check for Route Collisions in Omarchy Commands: A Complete Guide](/omacom/omarchy/how-can-i-check-for-route-collisions-in-omarchy-commands) Learn how to check for route collisions in Omarchy commands with `omarchy commands --check`. Detect binary route issues, missing metadata, and invalid booleans. A complete guide. - Tags: how-to-guide - Published: 2026-09-02 ### [The Complete Guide to Omarchy Command Groups: 43 System-Level Categories Explained](/omacom/omarchy/what-are-the-main-command-groups-in-omarchy) Discover the 43+ Omarchy command groups and understand how they are organized. This guide explains system-level categories following the omarchy-- pattern. Learn more now. - Tags: deep-dive - Published: 2026-09-02 ### [How to Get JSON Output from the Omarchy CLI: A Complete Guide](/omacom/omarchy/how-can-i-get-json-output-for-omarchy-cli-help) Easily get JSON output from the Omarchy CLI. Append --json to any command for machine-readable data. Your complete guide to Omarchy CLI JSON output. - Tags: how-to-guide - Published: 2026-09-02 ### [How the Omarchy CLI Handles `--help` and `-h` Flags: Complete Technical Guide](/omacom/omarchy/how-does-the-omarchy-cli-handle-help-flags-like-help) Discover how the Omarchy CLI handles --help and -h flags with its remaining_has_help_flag function. Learn how it intercepts help requests before they reach other binaries. - Tags: deep-dive - Published: 2026-09-02 ### [How Slow-Path Dispatch Works in the Omarchy CLI: A Complete Technical Breakdown](/omacom/omarchy/how-does-the-slow-path-dispatch-work-in-omarchy-cli) Discover how Omarchy CLI's slow-path dispatch dynamically finds commands by scanning script metadata after fast-path lookup fails. Learn the technical details. - Tags: deep-dive - Published: 2026-09-02 ### [How Fast-Path Dispatch Works in the Omarchy CLI: A Two-Stage Routing Deep Dive](/omacom/omarchy/how-does-the-fast-path-dispatch-work-in-omarchy-cli) Discover how Omarchy CLI's fast-path dispatch uses two-stage routing to speed up command invocations, even with hundreds of commands. Learn about filesystem stat calls and metadata parsing. - Tags: deep-dive - Published: 2026-09-02 ### [Omarchy Command Metadata Convention: Complete Guide to Script Headers](/omacom/omarchy/what-is-the-metadata-convention-for-omarchy-commands) Discover the Omarchy command metadata convention. Learn how to use # omarchy:key=value script headers in Bash to define command attributes for the central router. - Tags: deep-dive - Published: 2026-09-02 ### [How Omarchy Maps Commands to Executables: A Deep Dive into the CLI Router](/omacom/omarchy/how-are-omarchy-commands-mapped-to-executables) Discover how Omarchy maps CLI commands to executables using a filename convention and a Bash router script. Learn about binary discovery, metadata parsing, and invocation dispatch. - Tags: deep-dive - Published: 2026-09-02 ### [What Does the `omarchy finalize user` Command Do? Complete Guide to Per-User Setup](/omacom/omarchy/what-does-the-omarchy-finalize-user-command-do) Discover what the omarchy finalize user command does. Learn about per user runtime finalization, symlinks, directory setup, and application defaults for your omarchy setup. - Tags: how-to-guide - Published: 2026-09-02 ### [How to Reset Omarchy Configurations to Defaults](/omacom/omarchy/how-can-i-reset-my-omarchy-configurations-to-defaults) Easily reset Omarchy configurations to defaults with omarchy-refresh-config. This command backs up your settings and restores them to their original state. - Tags: how-to-guide - Published: 2026-09-02 ### [What Is the Finalize Step in Omarchy User Setup?](/omacom/omarchy/what-is-the-finalize-step-in-omarchy-user-setup) Understand the Finalize step in Omarchy user setup. Learn how omarchy-provision-user creates symlinks, configures apps, and runs scripts for a personalized environment. - Tags: getting-started - Published: 2026-09-02 ### [What Is the Seed Layer in Omarchy's HOME Population?](/omacom/omarchy/what-is-the-seed-layer-in-omarchys-home-population) Discover Omarchy's HOME population Seed layer. Learn how baseline configuration files are set up in new user home directories during account creation, ensuring consistent defaults. - Tags: internals - Published: 2026-09-02 ### [How Omarchy Populates User Home Directories: The Three-Stage Model](/omacom/omarchy/how-are-user-home-directories-populated-in-omarchy) Discover how Omarchy populates user home directories using its three-stage Seed, Finalize, and Resync model. Learn about skeleton copying, runtime configuration, and refresh cycles. - Tags: internals - Published: 2026-09-02 ### [Omarchy File Layout: Complete Guide to Directory Structure and Installation Paths](/omacom/omarchy/where-can-i-find-a-detailed-file-layout-for-omarchy-installations) Explore the comprehensive Omarchy file layout guide. Understand directory structure and installation paths for Seed, Finalize, and Resync layers. Find official docs in the repository. - Tags: how-to-guide - Published: 2026-09-02 ### [What Is the Purpose of the `omarchy-settings` Arch Package?](/omacom/omarchy/what-is-the-purpose-of-the-omarchy-settings-arch-package) Discover the essential role of the omarchy-settings Arch package. It provides the critical configuration files and defaults needed before main omarchy components can operate. - Tags: how-to-guide - Published: 2026-09-02 ### [What Is the Purpose of the omarchy Arch Package? A Complete Technical Breakdown](/omacom/omarchy/what-is-the-purpose-of-the-omarchy-arch-package) Discover the purpose of the omarchy Arch package. Learn how it transforms Omarchy into an installable Arch Linux distribution with session management, theming, and system tooling. - Tags: deep-dive - Published: 2026-09-02 ### [Omarchy Arch Packages: The Two Core Packages for Installation (`omarchy` and `omarchy-settings`)](/omacom/omarchy/what-are-the-two-main-arch-packages-for-omarchy) Discover the two core Omarchy Arch packages: omarchy for runtime binaries and omarchy-settings for UI configurations. Essential for a complete Omarchy installation. - Tags: getting-started - Published: 2026-09-02 ### [How Omarchy Is Distributed and Packaged: Arch Linux Package Management Explained](/omacom/omarchy/how-is-omarchy-distributed-and-packaged) Discover how Omarchy is distributed and packaged using Arch Linux packages and pacman. Learn about its update channels and AUR support for seamless software management. - Tags: internals - Published: 2026-09-02 ### [How to Trigger Omarchy Migrations: Complete Command Reference and Automation Guide](/omacom/omarchy/how-to-trigger-omarchy-migrations) Learn how to trigger Omarchy migrations using the omarchy-migrate command. This guide covers command reference and automation for managing your Omakia database schema efficiently. - Tags: how-to-guide - Published: 2026-09-01 ### [How Omarchy Migrations Work: A Complete Guide to System Updates](/omacom/omarchy/how-do-omarchy-migrations-work) Learn how Omarchy migrations work with this guide. Discover how per-user shell scripts update your system state safely via marker files and the omarchy-migrate command. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Manage Idempotency Markers in Omarchy: A Complete Guide with Code Examples](/omacom/omarchy/how-to-manage-idempotency-markers-in-omarchy) Learn to manage idempotency markers in Omarchy with our complete guide. Ensure safe, repeatable script execution and prevent duplicate changes. - Tags: how-to-guide - Published: 2026-09-01 ### [How Omarchy Handles Configuration Updates for Existing Users](/omacom/omarchy/how-does-omarchy-handle-configuration-updates-for-existing-users) Omarchy automatically refreshes user configurations safely. Learn how omarchy-refresh-config preserves your customizations with automatic backups. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Run Omarchy User Provisioning Commands: The Complete Guide](/omacom/omarchy/how-to-run-omarchy-user-provisioning-commands) Learn how to run Omarchy user provisioning commands like omarchy-provision-user. Complete your Omarchy environment setup efficiently after initial login. Use --force to re-run. - Tags: how-to-guide - Published: 2026-09-01 ### [How Omarchy's Provisioning System Populates the User's Home Directory: A Complete Technical Guide](/omacom/omarchy/how-does-omarchy-provisioning-system-populate-the-users-home-directory) Discover how Omarchy provisioning populates user home directories in this technical guide. Learn about its three-stage pipeline for configuration, assets, and permissions. - Tags: deep-dive - Published: 2026-09-01 ### [How to Configure Omarchy Shell (`shell.toml`): A Complete Guide to Theme Customization](/omacom/omarchy/how-to-configure-omarchy-shell.toml) Customize your Omarchy shell by editing shell.toml. Learn to configure themes, bars, fonts, and spacing for a personalized look. Reload changes easily with omarchy-restart-shell. - Tags: how-to-guide - Published: 2026-09-01 ### [Omarchy Color Mixing Functions in Themes: How to Blend and Transform Colors](/omacom/omarchy/what-color-mixing-functions-are-available-in-omarchy-themes) Discover Omarchy color mixing functions like mix, mix_strip, and mix_rgb. Learn to blend and transform colors effortlessly within your Omarchy themes. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Use Omarchy Template Variables for Theming: A Complete Guide](/omacom/omarchy/how-to-use-omarchy-template-variables-for-theming) Learn to use Omarchy template variables for theming. This guide shows how to leverage placeholders in tpl files to customize your theme's colors and gradients. - Tags: how-to-guide - Published: 2026-09-01 ### [Omarchy `colors.toml` Structure: Complete Guide to Theme Configuration](/omacom/omarchy/what-is-the-structure-of-omarchy-colors.toml) Explore the Omarchy colors.toml structure. Learn how to configure your theme's complete color palette across meta, core accents, backgrounds, foregrounds, and basic colors for a personalized look. - Tags: deep-dive - Published: 2026-09-01 ### [How to Create a Custom Omarchy Theme: A Complete Guide](/omacom/omarchy/how-to-create-a-custom-omarchy-theme) Learn how to create a custom Omarchy theme. Copy an existing theme, edit colors.toml for your palette, add overrides, and apply your new theme with omarchy-theme-set. A complete guide for Omarchy users. - Tags: how-to-guide - Published: 2026-09-01 ### [How to Set a New Omarchy Theme: Complete Guide to Theme Activation](/omacom/omarchy/how-to-set-a-new-omarchy-theme) Learn how to set a new Omarchy theme with our complete guide. Activate custom themes easily using omarchy-theme-set and understand the staged rendering pipeline for seamless theme deployment. - Tags: how-to-guide - Published: 2026-09-01 ### [Where Are Omarchy Themes Stored? System-Wide and User Directory Paths Explained](/omacom/omarchy/where-are-omarchy-themes-stored) Find Omarchy themes easily. Learn system-wide and user directory paths for theme storage in the Omarchy repository. Discover where your Omarchy themes are kept. - Tags: how-to-guide - Published: 2026-09-01 ### [How the Omarchy Theming System Works: Architecture, Activation Flow, and Customization](/omacom/omarchy/how-does-the-omarchy-theming-system-work) Explore the Omarchy theming system architecture, activation flow, and customization. Learn how Omarchy enables secure, reproducible theme switching with user overrides. - Tags: architecture - Published: 2026-09-01 ### [Omarchy Plugin Kinds Explained: A Complete Guide to Plugin Types in the Omarchy Desktop](/omacom/omarchy/what-are-omarchy-plugin-kinds) Understand Omarchy plugin kinds. Learn how manifest.json defines UI, service, and agent plugins for loading, rendering, and management in this comprehensive guide. - Tags: deep-dive - Published: 2026-09-01 ### [How Omarchy CLIs Communicate with the Shell: IPC Architecture Explained](/omacom/omarchy/how-do-omarchy-clis-communicate-with-the-shell) Discover how Omarchy CLIs communicate with the shell using Unix domain sockets and JSON IPC. Learn how omarchy-shell forwards requests to Quickshell via omarchy-ipc. - Tags: internals - Published: 2026-09-01 ### [How to Restart the Omarchy Shell: Safe Restart Procedures for Quickshell UI](/omacom/omarchy/how-to-restart-the-omarchy-shell) Restart the Omarchy shell safely using omarchy-restart-shell. This process coordinates Hyprland and Quickshell for a fresh UI instance. Learn safe restart procedures. - Tags: how-to-guide - Published: 2026-09-01 ### [What Is Quickshell in Omarchy? Understanding the Core Desktop Runtime Engine](/omacom/omarchy/what-is-quickshell-in-omarchy) Discover Quickshell in Omarchy, the QML-based compositor powering the desktop. Learn how this single runtime engine uses dynamic plugins for every UI element. - Tags: deep-dive - Published: 2026-09-01 ### [How to Create a Custom Omarchy CLI Command](/omacom/omarchy/how-to-create-a-custom-omarchy-cli-command) Learn to create a custom Omarchy CLI command by adding an executable script to bin/ with embedded metadata for automatic help generation. Simplify your workflow today. - Tags: how-to-guide - Published: 2026-09-01 ### [How the Omarchy CLI Router Works: Longest-Prefix Routing in Bash](/omacom/omarchy/how-does-the-omarchy-cli-router-work) Discover how the Omarchy CLI router uses longest-prefix routing in Bash to manage omarchy-* executables with metadata-driven commands. Streamline your command line experience. - Tags: internals - Published: 2026-09-01 ### [What Window Manager Does Omarchy Use? Understanding the Hyprland Foundation](/omacom/omarchy/what-window-manager-does-omarchy-use) Discover the Hyprland window manager powering Omarchy. Learn how Omarchy leverages Hyprland for a streamlined and customizable desktop experience. - Tags: deep-dive - Published: 2026-09-01 ### [How Omarchy Handles System Updates and Migrations: A Complete Technical Breakdown](/omacom/omarchy/how-does-omarchy-handle-system-updates-and-migrations) Learn how Omarchy orchestrates system updates and migrations via a single atomic pipeline. Discover package upgrades, snapshots, lock handling, and migration scripts for a retry-safe workflow. - Tags: deep-dive - Published: 2026-08-31 ### [How Omarchy Syncs Terminal Colors: Complete Architecture Guide](/omacom/omarchy/how-does-omarchy-sync-terminal-colors) Discover how Omarchy syncs terminal colors. Learn the architecture, from centralizing palettes to generating theme files, and understand the automated process triggered by theme changes. - Tags: architecture - Published: 2026-08-31 ### [How to Override Theme Colors in Omarchy: Complete Customization Guide](/omacom/omarchy/how-to-override-theme-colors-in-omarchy) Override Omarchy theme colors by creating a user theme directory and editing colors.toml. Customize your Omarchy experience with complete control over your application's look and feel. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Create a Custom Omarchy Theme: A Complete Step-by-Step Guide](/omacom/omarchy/how-to-create-custom-omarchy-theme) Learn how to create a custom Omarchy theme by building a color palette and overriding templates. This step-by-step guide makes customizing your Omarchy experience easy and efficient. - Tags: how-to-guide - Published: 2026-08-31 ### [How the Omarchy Theming System Works: A Deep Dive Into Themes, Templates, and Color Pipelines](/omacom/omarchy/how-does-omarchy-theming-system-work) Explore the Omarchy theming system and its layered pipeline. Learn how palette files transform into desktop themes via template rendering and custom color helpers. - Tags: deep-dive - Published: 2026-08-31 ### [How to Use the Omarchy Menu as a dmenu Replacement: Complete CLI and Scripting Guide](/omacom/omarchy/how-to-use-omarchy-menu-as-dmenu-replacement) Replace dmenu with Omarchy menu using select or input modes. This guide shows how to leverage Omarchy for CLI and scripting, returning choices via stdout. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Create Custom Omarchy Menu Extensions: A Complete Guide](/omacom/omarchy/how-to-create-custom-omarchy-menu-extensions) Learn to create custom Omarchy menu extensions by editing the omarchy-menu.jsonc file. This guide details merging custom menus with defaults for a personalized experience. - Tags: how-to-guide - Published: 2026-08-31 ### [How the Omarchy Menu Is Defined: Complete Guide to JSON-C Configuration and Dynamic Providers](/omacom/omarchy/how-is-omarchy-menu-defined) Learn how the Omarchy menu is defined using a single JSON-C config file. Explore properties like icon, label, action, and dynamic providers to customize your menu. - Tags: deep-dive - Published: 2026-08-31 ### [How to Reorder Omarchy Status Bar Plugins: Complete Configuration Guide](/omacom/omarchy/how-to-reorder-omarchy-status-bar-plugins) Easily reorder Omarchy status bar plugins using shell.json configuration or the omarchy bar CLI. Get instant updates without restarting. Learn how to customize your status bar now. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Configure the Omarchy Shell: Complete Guide to shell.json](/omacom/omarchy/how-to-configure-omarchy-shell) Learn how to configure the Omarchy shell with our complete guide to shell.json. Customize your shell by following these simple steps and override default settings for personalized control. - Tags: how-to-guide - Published: 2026-08-31 ### [How Omarchy Detects Route Collisions: Static Analysis of CLI Command Routing](/omacom/omarchy/how-are-omarchy-route-collisions-detected) Omarchy statically detects route collisions during router initialization by mapping route strings to binaries, logging conflicts for duplicate registrations. - Tags: internals - Published: 2026-08-31 ### [How to Get a Machine-Readable Omarchy Command List](/omacom/omarchy/how-to-get-machine-readable-omarchy-command-list) Easily get your machine-readable Omarchy command list using the omarchy commands --json command. Automate your workflows with structured JSON output. - Tags: how-to-guide - Published: 2026-08-31 ### [Omarchy Command Metadata: Complete Guide to Available Fields and Usage](/omacom/omarchy/what-metadata-is-available-for-omarchy-commands) Explore Omarchy command metadata fields for automatic help generation, shell completion, and more. Discover how to leverage built-in comments for enhanced command functionality. - Tags: api-reference - Published: 2026-08-31 ### [How to Get Help with Omarchy Commands: Complete CLI Help Guide](/omacom/omarchy/how-to-get-help-with-omarchy-commands) Master Omarchy commands with this CLI help guide. Learn to get help for top-level commands, specific usage, and list all available commands easily. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Discover Omarchy Commands: A Complete Guide to CLI Exploration](/omacom/omarchy/how-to-discover-omarchy-commands) Easily discover Omarchy commands with the `omarchy commands` CLI tool. Explore all options using flags like --all, --json, or --markdown for comprehensive CLI exploration in this complete guide. - Tags: how-to-guide - Published: 2026-08-31 ### [How Does the Omarchy CLI Router Work? A Deep Dive into the Bash-Based Command Router](/omacom/omarchy/how-does-omarchy-cli-router-work) Discover how the Omarchy CLI router uses Bash to auto-discover commands, parse metadata, and execute with longest-prefix matching. Learn the inner workings of this powerful command router. - Tags: deep-dive - Published: 2026-08-31 ### [Omarchy System Defaults Location: Where Configuration Files Are Stored and How to Refresh Them](/omacom/omarchy/where-are-omarchy-system-defaults-located) Locate Omarchy system defaults in the default/ directory. Learn how the omarchy-refresh-config command copies configuration files to your home directory. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Customize Omarchy User Configuration: Complete Guide to Themes, Shell Layout, and Hooks](/omacom/omarchy/how-to-customize-omarchy-user-configuration) Master Omarchy user configuration with our guide. Learn to customize themes, shell layout, and hooks using JSON/TOML files in ~/.config/omarchy/ without recompilation. - Tags: how-to-guide - Published: 2026-08-31 ### [What Wayland Compositor Does Omarchy Use?](/omacom/omarchy/what-wayland-compositor-does-omarchy-use) Discover Omarchy's Wayland compositor choice. Omarchy leverages Hyprland, a dynamic tiling Wayland compositor and window manager, for its desktop environment. - Tags: deep-dive - Published: 2026-08-31 ### [What Is Omarchy Based On? Arch Linux, Hyprland, and Quickshell Explained](/omacom/omarchy/what-is-omarchy-based-on) Discover Omarchy's foundation: Arch Linux for a rolling release, Hyprland for a dynamic tiling Wayland experience, and Quickshell for customizable widgets and panels. - Tags: deep-dive - Published: 2026-08-31 ### [How to Install Omarchy Linux Distribution: Complete Guide to ISO Installation](/omacom/omarchy/how-to-install-omarchy-linux-distribution) Learn how to install Omarchy Linux from an ISO. This guide covers full-disk or dual-boot installation with default LUKS encryption for a secure OS. - Tags: how-to-guide - Published: 2026-08-31 ### [How to Re-Sync Configuration Files to Omarchy Defaults: A Complete Guide](/omacom/omarchy/how-can-i-re-sync-configuration-files-to-omarchy-defaults) Restore Omarchy defaults easily. Learn how to re-sync configuration files using omarchy-refresh-config and automatically back up current settings. - Tags: how-to-guide - Published: 2026-08-30 ### [Omarchy User Provisioning Process: First-Boot Wizard Technical Guide](/omacom/omarchy/what-is-the-omarchy-user-provisioning-process) Learn the Omarchy user provisioning process with our technical guide. Discover how the first-boot wizard automates user setup, system settings, and encryption. - Tags: technical-guide - Published: 2026-08-30 ### [How Omarchy's Theme Template System Works: Dynamic Configuration Rendering](/omacom/omarchy/how-does-omarchys-theme-template-system-work) Discover how Omarchy's theme template system renders .tpl files into application configs. Learn about placeholder substitution, user vs. built-in templates, and dynamic configuration. - Tags: internals - Published: 2026-08-30 ### [Omarchy Typography Scale: How the Rem-Based System Works in Themes](/omacom/omarchy/how-is-the-typography-scale-managed-in-omarchy-themes) Discover how Omarchy themes manage typography using a rem-based scale. Learn how base-size and semantic tokens ensure proportional scaling for your UI. - Tags: how-to-guide - Published: 2026-08-30 ### [What Are the Standardized Interactive States for Controls in Omarchy Themes?](/omacom/omarchy/what-are-the-standardized-interactive-states-for-controls-in-omarchy-themes) Discover the four standardized interactive states in Omarchy themes Normal Hover Focus and Selected for consistent UI feedback using reusable tokens in shell themes - Tags: deep-dive - Published: 2026-08-30 ### [How the Color Palette Is Defined in Omarchy Themes: A Declarative Guide to colors.toml](/omacom/omarchy/how-is-the-color-palette-defined-in-omarchy-themes) Discover how Omarchy themes define color palettes using colors.toml. Learn how hex values map to UI roles for automatic application across configurations. - Tags: deep-dive - Published: 2026-08-30 ### [Where Are Omarchy Themes Stored and What Files Are Involved?](/omacom/omarchy/where-are-omarchy-themes-stored-and-what-files-are-involved) Discover where Omarchy themes are stored in system and user directories, detailing involved files like .tpl templates and activation via omarchy-theme-set. Optimize your Omarchy setup now. - Tags: how-to-guide - Published: 2026-08-30 ### [How to Create Custom Bar Modules in the Omarchy Shell: A Complete Guide](/omacom/omarchy/can-i-create-custom-bar-modules-in-omarchy-shell) Learn to create custom bar modules in Omarchy shell with QML components. Follow our guide to enhance your shell experience by adding unique widgets to your bar. - Tags: how-to-guide - Published: 2026-08-30 ### [Omarchy Shell Bar Layout Configuration: JSON Schema, Loading Logic, and Runtime Updates](/omacom/omarchy/how-is-the-omarchy-shells-bar-layout-configured) Configure the Omarchy shell bar layout using JSON schema for left, center, and right widgets. Learn about loading logic and runtime updates without restarts for the omacom/omarchy repository. - Tags: how-to-guide - Published: 2026-08-30 ### [How to Apply a Theme to the Omarchy Shell](/omacom/omarchy/how-do-i-apply-a-theme-to-the-omarchy-shell) Easily apply a theme to the Omarchy shell using the omarchy-theme-set utility and applyTheme IPC command. Customize your interface instantly without restarting your shell. - Tags: how-to-guide - Published: 2026-08-30 ### [How to Call a Method on a Loaded Omarchy Shell Plugin: The Complete IPC Guide](/omacom/omarchy/how-do-i-call-a-method-on-a-loaded-omarchy-shell-plugin) Learn to call methods on loaded Omarchy shell plugins using the omarchy-shell ipc command. This guide explains the process and payload for effective Inter-Process Communication. - Tags: how-to-guide - Published: 2026-08-30 ### [How to Install and Enable Plugins in Omarchy: A Complete Guide](/omacom/omarchy/how-do-i-install-and-enable-plugins-in-omarchy) Learn how to install and enable Omarchy plugins easily. Follow our guide to clone repositories and activate plugins within the Omarchy shell UI for enhanced functionality. - Tags: how-to-guide - Published: 2026-08-30 ### [Understanding the Different Plugin Kinds in Omarchy: A Complete Guide](/omacom/omarchy/what-are-the-different-plugin-kinds-in-omarchy) Explore the six plugin kinds in Omarchy bar bar-widget service panel background and agents to understand component integration and rendering in the Quickshell desktop environment. - Tags: deep-dive - Published: 2026-08-30 ### [How to Define a Custom Plugin manifest.json for Omarchy: Complete Developer Guide](/omacom/omarchy/how-do-i-define-a-custom-plugin-manifestjson-for-omarchy) Learn how to define a custom plugin manifest.json for Omarchy. This guide details the metadata and entry-point mappings needed for the Quickshell runtime. - Tags: how-to-guide - Published: 2026-08-30 ### [Omarchy Quickshell Plugin System: Architecture, Discovery, and Runtime Loading](/omacom/omarchy/what-is-the-plugin-system-for-the-omarchy-quickshell) Discover the Omarchy Quickshell plugin system. Learn how it loads plugins at runtime using JSON manifests for widgets, panels, and services in a reactive QML shell. - Tags: architecture - Published: 2026-08-30 ### [How to Launch or Restart the Omarchy Shell: Complete Guide](/omacom/omarchy/how-do-i-launch-or-restart-the-omarchy-shell) Learn how to launch or restart the Omarchy shell using omarchy-launch-shell and omarchy-restart-shell. Preserve your Hyprland session with this complete guide. - Tags: how-to-guide - Published: 2026-08-30 ### [How to Create Custom Groups for the Omarchy CLI](/omacom/omarchy/can-i-create-custom-groups-for-omarchy-cli-commands) Learn to create custom groups for Omarchy CLI commands. Add entries to GROUP_DESCRIPTIONS and create scripts in bin to extend Omarchy's functionality. - Tags: how-to-guide - Published: 2026-08-30 ### [How Omarchy Handles Command Route Resolution and Fallbacks: Inside the Bash Driver Architecture](/omacom/omarchy/how-does-omarchy-handle-command-route-resolution-and-fallbacks) Discover how Omarchy's Bash driver resolves CLI commands using a two-phase routing system with automatic fallbacks. Ensure command accessibility with its smart architecture. - Tags: internals - Published: 2026-08-30 ### [Understanding the Metadata Format for Omarchy Commands: A Complete Guide](/omacom/omarchy/what-is-the-metadata-format-for-omarchy-commands) Learn the Omarchy metadata format for CLI commands. This guide details group, name, summary, arguments, and more, embedded in executable files. - Tags: deep-dive - Published: 2026-08-30 ### [How to Define a New Omarchy CLI Command: Step-by-Step Guide](/omacom/omarchy/how-can-i-define-a-new-omarchy-cli-command) Define a new Omarchy CLI command by creating a script in bin/ following the omarchy-- convention. Learn how to register groups and test your new command. - Tags: how-to-guide - Published: 2026-08-30 ### [How Omarchy System Defaults Are Managed for New Users](/omacom/omarchy/how-are-omarchy-system-defaults-managed-for-new-users) Learn how Omarchy manages system defaults for new users. Discover how omarchy-refresh-config copies version-controlled configurations and preserves customizations. - Tags: how-to-guide - Published: 2026-08-30 ### [What is Quickshell in Omarchy? The Runtime Engine Explained](/omacom/omarchy/what-is-quickshell-in-the-context-of-omarchy) Discover Quickshell, Omarchy's powerful runtime engine. Learn how this single process powers desktop UI, bars, panels, overlays, and background services via QML plugins. - Tags: deep-dive - Published: 2026-08-30 ### [How Omarchy CLI Command Center Routing Works: A Deep Dive into the Bash Router](/omacom/omarchy/how-does-omarchys-cli-command-center-routing-work) Discover how Omarchy's pure Bash router dynamically routes CLI commands. Learn about metadata parsing and efficient dispatch to binaries via associative arrays. - Tags: deep-dive - Published: 2026-08-30