skills.rest
khrore
khroreCOMMUNITY
Explore all skills by this author →
GitHub

omarchy

Manage Omarchy desktop and Hyprland configuration files under ~/.config/.

Updated Apr 15, 2025
Search Tags:#dotfiles#configuration#themes#waybar#hyprland#omarchy#linux-desktop
One-click install
npx skills add https://github.com/khrore/nix-config --skill omarchy-khrore
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: omarchy
Source: https://github.com/khrore/nix-config/tree/main/dotfiles/nixos/.local/share/linux-desktop/default/omarchy-skill
Command: npx skills add https://github.com/khrore/nix-config --skill omarchy-khrore

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a guided, safety-first workflow for end-user customization of Omarchy desktop components so users can modify appearance, keybindings, monitors, and terminal settings without breaking system updates or upstream-managed defaults.

Core Features & Use Cases

  • Safe editing guidance for Hyprland, Waybar, Walker, Mako, terminals, and Omarchy theme and hook locations.
  • Operational rules that mandate editing only under ~/.config/, backing up files before changes, and using omarchy-* commands to apply or refresh components.
  • Protection from accidental edits to the distribution-managed source in ~/.local/share/linux-desktop/ by encouraging read-only inspection and forbidding writes there.
  • Use case: Customize a Hyprland keybinding or theme, back up the original, add an unbind if reusing a key, and run the appropriate omarchy-restart or omarchy-theme-set to apply the change.

Quick Start

Edit the config file you want under ~/.config/, back it up first, then apply the change using the matching omarchy refresh or restart command.

Frequently Asked Questions about omarchy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I customize Hyprland keybindings and themes without breaking system updates?▼

To customize Hyprland safely, edit configuration files only within the ~/.config/ directory, back up the original files first, and apply changes using omarchy-restart or omarchy-theme-set commands to avoid update conflicts.

Can I modify Waybar and terminal configurations on an Omarchy desktop installation?▼

Yes, you can modify Waybar, terminal, and Walker configurations by editing the respective files under ~/.config/, but you must avoid writing to ~/.local/share/linux-desktop/ to prevent conflicts with upstream Omarchy updates.

What is the safest workflow for changing display and workspace settings in Hyprland?▼

The safest workflow for changing Hyprland display and workspace settings is to edit user config files in ~/.config/hypr/, create a backup before making changes, and use the appropriate omarchy-restart command to refresh the components.

Why should I not edit files in the ~/.local/share/linux-desktop/ directory?▼

You should not edit files in ~/.local/share/linux-desktop/ because it contains distribution-managed source files; modifying them directly causes conflicts during Omarchy updates and overwrites upstream defaults.

How do I rebind a key in Hyprland that is already in use?▼

To rebind an existing Hyprland key, edit the configuration in ~/.config/hypr/, add an unbind instruction for the key you are reusing, back up the file, and run the matching omarchy refresh command to apply the new keybinding.

Related Skills

Explore More Software Engineering Skills→
miguelcsilvamiguelcsilva

omarchy

Manage and configure Omarchy desktop environment settings and user configuration files.

Community
Advanced
mlaurelmlaurel

Omarchy

Manage Omarchy Linux configurations and workflows under ~/.config.

Community
Advanced
tomiocktomiock

Omarchy

Plan, validate, and apply Linux desktop configuration changes via Omarchy.

Community
Advanced
aidansunburyaidansunbury

Omarchy

Enforce guardrails and backups for Omarchy configuration edits on Linux.

Community
Advanced