Skip to content
ArchEclipse

Common pages

↑↓to navigate↵to openescto close
Animations
On this page

Configuration

Animations

Tune Hyprland window animations and the Quickshell island motion separately.

ArchEclipse has two animation systems that are controlled independently:

  1. Hyprland animates windows, workspaces and special workspaces. It is configured in ~/.config/hypr/config/animations.lua.
  2. Quickshell animates the bar, islands, panels and toasts. It uses the motion tokens in theme/Theme.qml, driven by Settings.

Changing one does not change the other. If the desktop feels slow, check both.

Hyprland animations#

animations.lua defines reusable Bézier and spring curves, then attaches them to animation leaves. The tracked configuration is:

lua
local phi = 1.618
local phi_min = 0.618
local interval = phi * 2

hl.curve("ease", { type = "bezier", points = { { 0, 1 }, { phi_min, 1 } } })
hl.curve("overshoot", { type = "bezier", points = { { 0.5, 0.9 }, { 0.1, 1.1 } } })
hl.curve("rubber", { type = "spring", mass = 1, stiffness = 70, dampening = 10 })

local curve = "ease"

hl.config({
    animations = { enabled = true },
})

hl.animation({ leaf = "windowsIn", enabled = true, speed = interval, bezier = curve, style = "popin 85%" })
hl.animation({ leaf = "windowsOut", enabled = true, speed = interval, bezier = curve, style = "popin 85%" })
hl.animation({ leaf = "windowsMove", enabled = true, speed = interval, bezier = curve, style = "slide" })
hl.animation({ leaf = "workspaces", enabled = true, speed = interval, bezier = curve, style = "slide" })
hl.animation({ leaf = "specialWorkspace", enabled = true, speed = interval, bezier = curve, style = "slidevert" })
hl.animation({ leaf = "fadePopups", enabled = true, speed = interval, bezier = curve })

Other curves are defined but unused by default: default, wind, winIn, winOut, linear and overshoot. The layer animation is commented out; layers such as the wallpaper daemon use layerrule fades instead.

Adjust the feel#

Create a custom module that loads after the base config. For example, a faster window animation:

lua
-- ~/.config/hypr/config/custom/animations_fast.lua
hl.animation({
    leaf = "windowsIn",
    enabled = true,
    speed = 1.6,
    bezier = "ease",
    style = "popin 90%",
})

Then reload:

bash
hyprctl reload
hyprctl configerrors

Disable Hyprland animations#

lua
-- ~/.config/hypr/config/custom/animations_off.lua
hl.config({ animations = { enabled = false } })

Shell animations#

The shell's motion system is a Material-3-expressive-inspired token set in theme/Theme.qml. Every duration is multiplied by Settings.animationsEnabled ? Settings.animScale : 0, so the Settings panel can disable motion without editing QML.

Settings → Animations:

SettingDefaultNotes
EnabledonOff snaps all shell animation durations to zero
Speed1.00×0.2–2.0; lower is faster
Island styleEmphasizedStandard, Emphasized, Bouncy Fast, Bouncy Default, Bouncy Slow
Reveal-in pressure250 msHover dwell before islands open
Reveal-out pressure1000 msGrace period before they close

Available motion styles:

StyleCharacter
StandardSmooth, conventional easing
EmphasizedDefault; longer, expressive easing
Bouncy Fast / Default / SlowSpring-like overshoot at three speeds

The bar's island expansion, panel slides, hover previews, notification toasts and lock card use these tokens. Some bespoke animations (notification view transitions and the lock card spring) intentionally use their own curves.

Performance#

The defaults are tuned for integrated GPUs:

  • Hyprland blur is size = 4, passes = 4.
  • Shadows are disabled in the tracked config.
  • Window opacity is 0.85, which still requires compositing but not blur multiplication.
  • Shell motion durations are short by default (200–600 ms base values).

If animations stutter:

  1. Set Settings → Animations → Speed below 1.0, or disable shell animations.
  2. Reduce Decoration: Blur Size and Blur Passes in Settings → Hyprland. Blur cost grows with both.
  3. Enable Game Mode in Settings → Hyprland. It disables Hyprland animations, blur and shadows, sets gaps to zero, enables tearing and switches the power profile to performance when available.
  4. Check the monitor refresh rate with hyprctl monitors.

Troubleshooting#

SymptomCheck
Window animations ignore custom valueshyprctl configerrors; duplicate leaf in a later custom file
Everything animates despite settingsSettings → Animations → Enabled; the Hyprland switch is separate
Animations are choppyblur size/passes, refresh rate, Game Mode
Bar feels sluggish but windows are finelower shell animation speed or island style
No animations at allanimations.enabled in animations.lua or a custom override