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/hyprcursor.md
View on GitHub<!-- source: https://wiki.hypr.land/hypr-ecosystem/user/hyprcursor -->
<!-- wiki commit: 41c7222 (2026-11-20 18:16:21 +0100) -->
<!-- auto-generated by scripts/generate-references.sh - DO NOT EDIT MANUALLY -->
---
weight: 150
title: hyprcursor
---
[hyprcursor](https://github.com/hyprwm/hyprcursor) is a new cursor theme format that has many advantages over the widely used XCursor.
## Hyprcursor Themes
You will need to obtain those yourself.
If you are on the Discord server, see `#hyprcursor-themes`.
Put your theme(s) in `~/.local/share/icons` or `~/.icons`
> [!WARNING]
> It's not recommended to put cursor themes in system-wide `/usr/share/icons` due to potential permission issues.
You can set your theme with envvars, or with `hyprctl setcursor`.
Env:
- `HYPRCURSOR_THEME` controls the theme.
- `HYPRCURSOR_SIZE` controls the cursor size.
Example snippet of `hyprland.lua`:
```lua
hl.env("HYPRCURSOR_THEME", "MyCursor")
hl.env("HYPRCURSOR_SIZE", "24")
```
## Creating / Porting Themes
Go to the [hyprcursor repo](https://github.com/hyprwm/hyprcursor)
See the `docs/` and `hyprcursor-util/` directories for instructions.
## Important Notes
Although many apps support server-side cursors (e.g., Qt, Chromium, Electron, Hypr Ecosystem) some apps still don't (e.g., GTK).
Apps that do not support server-side cursors and hyprcursor will still fall back to XCursor.
For those apps, you need to export `XCURSOR_THEME` and `XCURSOR_SIZE` to a valid XCursor theme, and run
```sh
gsettings set org.gnome.desktop.interface cursor-theme 'THEME_NAME'
```
for GTK.
If GSettings schemas are not available to you (e.g., on NixOS you will get `No schemas installed`), you can instead run:
```sh
dconf write /org/gnome/desktop/interface/cursor-theme "'THEME_NAME'"
```
If the app is a flatpak, run:
```sh
flatpak override --filesystem=~/.themes:ro --filesystem=~/.icons:ro --user
```
and put your themes in both `/usr/share/themes` and `~/.themes`.
Also put your icons and XCursors in both `/usr/share/icons` and `~/.icons`.
## I Don't Want to Use hyprcursor
If you don't have any hyprcursor themes installed, Hyprland will fall back to XCursor, and use whatever you define with `XCURSOR_THEME` and `XCURSOR_SIZE`.
## My Cursor Is a Hyprland Icon?
See [FAQ](../../../faq)
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: 323k | 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: 323k | 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: 323k | Updated | Claude CodeCodex | Verified | Install |