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/animations.md
View on GitHub<!-- source: https://wiki.hypr.land/configuring/core/animations -->
<!-- wiki commit: 41c7222 (2026-11-20 18:16:21 +0100) -->
<!-- auto-generated by scripts/generate-references.sh - DO NOT EDIT MANUALLY -->
---
weight: 80
title: Animations
---
## General
Animations are declared with the `hl.animation()` method.
Syntax:
```
hl.animation({ leaf = string, enabled = bool, speed = float, curve = string, style? = string })
```
- `leaf` is the scope of the animation. See [Animation tree](#animation-tree).
- `enabled` can be either `true` to enable or `false` to disable. _Note:_ if it's `false`, you can omit further arguments.
- `speed` is the number of *deciseconds* (100ms each) the animation will take. For example, `speed = 1` = 100ms.
- `bezier`/`spring` is a curve name, see [curves](#curves).
- `style` is the animation style. See [Animation tree](#animation-tree).
### Examples
```lua
hl.animation({ leaf = "workspaces", enabled = true, speed = 8, bezier = "my_epic_bezier" })
hl.animation({ leaf = "windows", enabled = true, speed = 10, spring = "my_epic_spring", style = "slide"})
hl.animation({ leaf = "fade", enabled = 0 })
```
### Animation tree
The animations are a tree.
If an animation is unset, it will inherit its parent's values.
```plain
global
↳ windows - styles: slide, popin, gnomed
↳ windowsIn - window open - styles: same as windows
↳ windowsOut - window close - styles: same as windows
↳ windowsMove - everything in between, moving, dragging, resizing.
↳ layers - styles: slide, popin, fade
↳ layersIn - layer open
↳ layersOut - layer close
↳ fade
↳ fadeIn - fade in for window open
↳ fadeOut - fade out for window close
↳ fadeSwitch - fade on changing activewindow and its opacity
↳ fadeShadow - fade on changing activewindow for shadows
↳ fadeGlow - fade on changing activewindow for glow
↳ fadeDim - the easing of the dimming of inactive windows
↳ fadeLayers - for controlling fade on layers
↳ fadeLayersIn - fade in for layer open
↳ fadeLayersOut - fade out for layer close
↳ fadePopups - for controlling fade on Wayland popups
↳ fadePopupsIn - fade in for Wayland popup open
↳ fadePopupsOut - fade out for Wayland popup close
↳ fadeDpms - for controlling fade when dpms is toggled
↳ border - for animating the border's color switch speed
↳ borderangle - for animating the border's gradient angle - styles: once (default), loop
↳ shadowangle - for animating the shadow's gradient angle - styles: once (default), loop
↳ glowangle - for animating the glow's gradient angle - styles: once (default), loop
↳ workspaces - styles: slide, slidevert, fade, slidefade, slidefadevert
↳ workspacesIn - styles: same as workspaces
↳ workspacesOut - styles: same as workspaces
↳ specialWorkspace - styles: same as workspaces
↳ specialWorkspaceIn - styles: same as workspaces
↳ specialWorkspaceOut - styles: same as workspaces
↳ zoomFactor - animates the screen zoom
↳ monitorAdded - monitor added zoom animation
```
> [!WARNING]
> Using the `loop` style for `*angle` animations requires Hyprland to _constantly_ render new frames at a frequency equal to your screen's refresh rate (e.g. 60 times per second for a 60hz monitor), which might stress your CPU/GPU and will impact battery life.
> This will apply even if animations are disabled or the affected decorations are not visible.
## Curves
### Bezier
A cubic [Bézier curve](https://en.wikipedia.org/wiki/B%C3%A9zier_curve) is a simple spline defined by 4 points, two of which (the middle ones) are configurable.
```lua
hl.curve( NAME, { type = "bezier", points = { {X0, Y0}, {X1, Y1} } })
```
[cssportal.com](https://www.cssportal.com/css-cubic-bezier-generator/) can be a useful website to design your own Bézier.
If you want to instead choose from a list of pre-made Béziers, you can check out [easings.net](https://easings.net).
### Spring
A spring curve is one commonly found on Apple's systems, and is defined by mass, stiffness and damping.
It's generally recommended to keep mass at 1, and adjust stiffness and damping alone.
```lua
hl.curve(NAME, { type = "spring", mass = float, stiffness = float, damping = float })
```
The more "stiffness", the more speed, and the more "damping", the less bounce.
#### Damping
##### Critical Damping
If the spring is critically damped, it settles fast and doesn't overshoot (no bounce).
Critical damping occurs when \(\zeta = 1\), where
\[
\zeta = \frac{c}{c_c} = \frac{c}{2\sqrt{k\,m}}, \quad
\begin{cases}
c & \text{damping coefficient*} \\
c_c & \text{critical damping coefficient} \\
k & \text{stiffness} \\
m & \text{mass}
\end{cases}
\]
> \* This is the damping value you give to the curve.
You probably want your damping around `0.6` to `0.8` for it to feel responsive and smooth.
##### Overdamped
Occurs when \(\zeta > 1\).
Returns slowly, no oscillation (doesn't bounce).
##### Underdamped
Occurs when \(\zeta < 1\).
Oscillates (bounces), decays\* exponentially.
> \* The amplitude of the bounces shrinks exponentially over time.
### Examples
```lua
hl.curve( "overshoot", { type = "bezier", points = { {0.5, 0.9}, {0.1, 1.1} } } )
hl.curve( "rubber", { type = "spring", mass = 1, stiffness = 70, damping = 10 } )
```
### Extras
For animation styles `popin` in `windows`, you can specify a minimum percentage to start from.
For example, the following will make the window animate from 80% to 100% of its size:
```lua
hl.animation({ leaf = "windows", enabled = true, speed = 8, curve = "default", style = "popin 80%" })
```
For animation styles `slide`, `slidevert`, `slidefade` and `slidefadevert` in `workspaces`, you can specify a movement percentage.
For example, the following will make windows move 20% of the screen width:
```lua
hl.animation({ leaf = "workspaces", enabled = true, speed = 8, curve = "default", style = "slidefade 20%" })
```
For animation styles `slide` in `windows` and `layers` you can specify a forced side.
You can choose between `top`, `bottom`, `left` or `right`.
```lua
hl.animation({ leaf = "windows", enabled = true, speed = 8, curve = "default", style = "slide left" })
```
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 |