hyprland

Configures Hyprland Wayland compositor settings on NixOS systems.

Updated Apr 3, 2026
One-click install
npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill hyprland-kettleofketchup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyprland
Source: https://github.com/kettleofketchup/KettleOfSkills/tree/main/plugins/hyprland/skills/hyprland
Command: npx skills add https://github.com/kettleofketchup/KettleOfSkills --skill hyprland-kettleofketchup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configuring the Hyprland Wayland compositor on NixOS requires piecing together scattered, often outdated documentation for GPU driver setup, Wails application compatibility, animated wallpapers, and home-manager integration, leading to hours of debugging blank screens, rendering issues, and broken flake configurations.

Core Features & Use Cases

  • Multi-GPU Smart Defaults: Pre-built NixOS modules and environment variable matrices for Intel, AMD, NVIDIA, and hybrid PRIME laptops, eliminating manual GPU driver configuration.
  • Wails Desktop Dev Support: Copy-paste fixes for webkit2gtk blank windows, dev shell setup, and build tags to streamline Go desktop application development on Hyprland.
  • Complete Ecosystem Setup: Recommendations for Hyprland companion tools (hyprlock, waybar, mpvpaper), animated wallpaper configuration, and full flake.nix examples for production-ready deployments. Use Case: A developer building Wails apps on a NixOS laptop with hybrid Intel/NVIDIA graphics can use this skill to generate a working flake configuration, apply the required webkit2gtk environment variables, and set up animated video wallpapers without troubleshooting rendering issues.

Quick Start

Use the hyprland skill to generate a complete working NixOS flake configuration for a system running Hyprland with integrated Intel graphics and a Wails development environment.

Frequently Asked Questions about hyprland

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

FAQPage Schema
How do I configure Hyprland on NixOS with NVIDIA drivers?

Configuring Hyprland on NixOS with NVIDIA drivers requires specific environment variables and PRIME settings for hybrid laptops. This skill provides pre-built NixOS modules and variable matrices to automatically resolve GPU driver compatibility.

Why does my Wails app show a blank screen on Wayland?

A blank Wails app screen on Wayland is typically caused by missing webkit2gtk environment variables. This skill delivers copy-paste fixes and dev shell configurations to resolve webkit2gtk rendering issues immediately.

What is the best way to set up animated wallpapers in Hyprland?

Setting up animated wallpapers in Hyprland involves configuring tools like mpvpaper alongside your Wayland compositor. This skill provides the complete ecosystem setup and configuration files needed for animated video wallpapers.

Can I use home-manager to manage my Hyprland configuration on NixOS?

Yes, home-manager can manage your Hyprland configuration on NixOS. This skill includes full flake.nix examples that integrate home-manager for deploying production-ready Wayland sessions.

Does this Hyprland setup support hybrid Intel and AMD graphics?

This Hyprland setup supports hybrid Intel, AMD, and NVIDIA graphics through smart default modules. It delivers the necessary environment variable matrices to handle hybrid PRIME laptop configurations without manual debugging.