hyprland

Configure and troubleshoot Hyprland Wayland compositor settings and documentation.

Updated Sep 28, 2025
One-click install
npx skills add https://github.com/cmac4603/dotfiiles --skill hyprland-cmac4603
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyprland
Source: https://github.com/cmac4603/dotfiiles/tree/main/dot_config/opencode/skill/hyprland
Command: npx skills add https://github.com/cmac4603/dotfiiles --skill hyprland-cmac4603

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides comprehensive assistance for configuring and troubleshooting the Hyprland Wayland compositor, enabling users to customize their desktop environment efficiently.

Core Features & Use Cases

  • Configuration Assistance: Guides users through creating and modifying Hyprland configuration files (hyprland.conf).
  • Feature Setup: Helps set up keybindings, window rules, monitor configurations, and animations.
  • Troubleshooting: Aids in identifying and resolving common Hyprland configuration issues.
  • Documentation Search: Provides a tool to quickly search local copies of Hyprland documentation for variables, keywords, and syntax.
  • Use Case: A user wants to set up a new keybinding to launch their terminal with a specific modifier key. This Skill can provide the exact syntax and guide them through adding it to their configuration.

Quick Start

Search the Hyprland documentation for information on configuring window rules.

Frequently Asked Questions about hyprland

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

FAQPage Schema
How do I configure keybindings in Hyprland?

To configure keybindings in Hyprland, you need to modify the `hyprland.conf` file by adding specific syntax that maps your desired modifier keys to actions like launching a terminal. This Skill provides the exact syntax required and guides you through updating your configuration file correctly.

What is the best way to set up window rules for Wayland applications?

Setting up window rules for Wayland applications involves adding specific rule definitions to your `hyprland.conf` file to manage how windows behave. This Skill helps you identify the correct variables and syntax by allowing you to quickly search local Hyprland documentation for your specific application needs.

How do I fix Hyprland configuration issues when my desktop environment isn't loading correctly?

Troubleshooting Hyprland configuration issues requires checking your `hyprland.conf` file for syntax errors in your monitor, animation, or window rule setups. This Skill aids in identifying and resolving common configuration mistakes to restore your Wayland compositor environment.

Can I search local Hyprland documentation for specific variables and keywords?

Yes, you can search local Hyprland documentation for specific variables and keywords using the included utility script. This allows you to quickly find the exact syntax and parameters needed for customizing your Wayland tiling window manager setup.

How do I configure multiple monitors in my Hyprland setup?

Configuring multiple monitors in Hyprland requires adjusting the monitor configuration section of your `hyprland.conf` file to define resolution, position, and scale. This Skill provides guidance on structuring these variables to correctly map your displays in the Wayland compositor.