marceloeatworld/hyprland-ai-skill
hyprland
FlaggedThis skill should be used when the user asks about "Hyprland configuration", "hyprland.lua", "hyprland.conf", "Hyprland Lua config", "hyprctl", "Hyprland keybinds", "Hyprland window rules", "Hyprland monitors", "Hyprland dispatchers", "Hyprland animations", "Hyprland workspaces", "Hyprland IPC", "Hyprland plugins", "hyprlock", "hypridle", "hyprpaper", "hyprcursor", "hyprpicker", "hyprsunset", "xdg-desktop-portal-hyprland", "Hyprland on NixOS", "Hyprland Home Manager", "Hyprland layouts", "Hyprland dwindle", "Hyprland master layout", "Hyprland FAQ", "Hyprland performance", "Hyprland Nvidia", "Hyprland screen sharing", "Hyprland special workspace", "Hyprland smart gaps", "Hyprland multi-monitor", "Hyprland tearing", or any topic related to configuring, troubleshooting, or extending the Hyprland Wayland compositor and its ecosystem tools.
references/environment-variables.md
View on GitHub<!-- source: https://wiki.hypr.land/configuring/core/environment-variables -->
<!-- wiki commit: 41c7222 (2026-11-20 18:16:21 +0100) -->
<!-- auto-generated by scripts/generate-references.sh - DO NOT EDIT MANUALLY -->
---
weight: 70
title: Environment variables
---
You can use the `hl.env()` method to set environment variables before the display server initializes, for example:
```lua
hl.env("GTK_THEME", "Nord")
```
> [!NOTE]
> When referencing existing environment variables like `$XDG_RUNTIME_DIR`, use `os.getenv()`.
> For example: `hl.env("SSH_AUTH_SOCK", os.getenv("XDG_RUNTIME_DIR") .. "/ssh-agent.socket")`
> [!WARNING]
> Please avoid putting Wayland-specific environment variables in `/etc/environment`.
> On traditional distros, doing so will cause all sessions (including Xorg ones) to pick them up, likely breaking them.
Please make sure you know what you are doing before copy-pasting environment variables listed here.
Some of them are for debugging, others may cause system instability if not used correctly.
## Hyprland Environment Variables
- `hl.env("HYPRLAND_TRACE", "1")` - Enables more verbose logging.
- `hl.env("HYPRLAND_NO_RT", "1")` - Disables realtime priority setting by Hyprland.
- `hl.env("HYPRLAND_NO_SD_NOTIFY", "1")` - If systemd, disables the `sd_notify` calls.
- `hl.env("HYPRLAND_NO_SD_VARS", "1")` - Disables management of variables in systemd and D-Bus activation environments.
- `hl.env("HYPRLAND_CONFIG", "/path/to/hyprland.lua")` - Specifies where you want your Hyprland configuration.
## [Aquamarine](../../../hypr-ecosystem/dev/aquamarine/)
<!-- NOTE: ref https://github.com/hyprwm/aquamarine/blob/main/docs/env.md -->
- `hl.env("AQ_TRACE", "1")` - Enables trace logging (very verbose).
- `hl.env("AQ_DRM_DEVICES", "...")` - Set an explicit list of DRM devices (GPUs) to use. It's a colon-separated list of paths, the first will be used as the primary GPU. Example: `/dev/dri/card1:/dev/dri/card0`.
- `hl.env("AQ_FORCE_LINEAR_BLIT", "0")` - Disables forcing linear explicit modifiers on Multi-GPU buffers to potentially workaround NVIDIA issues.
- `hl.env("AQ_MGPU_NO_EXPLICIT", "1")` - Disables passing of explicit fences for multi-GPU scanouts.
- `hl.env("AQ_NO_MODIFIERS", "1")` - Disables modifiers for DRM buffers.
- `hl.env("AQ_NO_KMS_REQUIREMENT", "1")` - Disable KMS requirement for starting on headless GPUs.
- `hl.env("AQ_NO_ATOMIC", "1")` - **(HEAVILY NOT RECOMMENDED)** Disable atomic modesetting.
## Mouse cursor
- `hl.env("XCURSOR_THEME", "MyCursorTheme")` - Set your cursor theme. The theme needs to be installed and readable by your user.
- `hl.env("XCURSOR_SIZE", "24")` - Set cursor size. See [here](../../../faq) for why you might want this variable set.
- `hl.env("HYPRCURSOR_THEME", "MyHyprcursorTheme")` - Check [the hyprcursor page](../../../hypr-ecosystem/user/hyprcursor) for information about hyprcursor.
- `hl.env("HYPRCURSOR_SIZE", "24")`
## Qt
- `hl.env("QT_QPA_PLATFORMTHEME", "qt6ct")` - Tells Qt based applications to pick your theme from qt6ct.
- `hl.env("QT_AUTO_SCREEN_SCALE_FACTOR", "1")` - [(From the Qt documentation)](https://doc.qt.io/qt-5/highdpi.html) enables automatic scaling, based on the monitor's pixel density.
- `hl.env("QT_WAYLAND_DISABLE_WINDOWDECORATION", "1")` - Disables window decorations on Qt applications.
## GTK
- `hl.env("GTK_THEME", "yourVeryPrettyTheme")` - Set a GTK theme manually, for those who want to avoid appearance tools such as lxappearance or nwg-look.
## GUI toolkits' backend
- `hl.env("GDK_BACKEND", "wayland,x11,*")` - GTK: Use Wayland if available; if not, try X11 and then any other GDK backend.
- `hl.env("QT_QPA_PLATFORM", "wayland;xcb")` - Qt: Use Wayland if available, fall back to X11 if not.
- `hl.env("SDL_VIDEODRIVER", "wayland")` - Run SDL2 applications on Wayland. Remove or set to `x11` if games that provide older versions of SDL cause compatibility issues.
- `hl.env("CLUTTER_BACKEND", "wayland")` - Clutter package already has Wayland enabled, this variable will force Clutter applications to try and use the Wayland backend.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |