Hyprland Documentation

Complete reference for the Hyprland Wayland compositor, auto-generated from the official wiki at https://wiki.hypr.land/.

The references/ directory contains the full, unmodified wiki markdown from https://github.com/hyprwm/hyprland-wiki, updated daily.

How to Use

1. Identify the topic from the user's question and read the matching reference file from the tables below.
2. Base answers on those files. If more detail is needed, fetch the latest docs from the raw GitHub URLs in Live Fetching.
3. Since Hyprland 0.55, the config is Lua (~/.config/hypr/hyprland.lua): hl.config({...}), hl.bind(...), hl.monitor({...}), hl.window_rule({...}), hl.on(...). The old hyprlang format (hyprland.conf) is deprecated. Check the user's version with hyprctl version when in doubt.
4. For Hyprland 0.54 and earlier, use hyprlang syntax and point the user to the versioned wiki at https://wiki.hypr.land/0.54.0/ (the reference files here track the current Lua docs).
5. Split configs use Lua require("subdir/file"), not the old source = keyword.
6. For NixOS users, note that hyprpm is unsupported on Nix — use Home Manager or the NixOS module for plugins.
7. For troubleshooting, check references/faq.md first.

Reference Files

Configuration