H
HyprL

Table of Contents

Introduction

Hyprland is known for its smooth and visually appealing animations. HyprL provides several pre-configured animation presets to enhance your desktop experience. This guide explains how animations are managed in HyprL and how you can customize them.

Understanding Hyprland Animations

Animations in Hyprland are defined in the animation block within your Hyprland configuration. HyprL organizes these settings into separate files for easier management. The main ~/.config/hypr/hyprland.conf file sources an animation configuration from ~/.config/hypr/conf/animation.conf.

For example, ~/.config/hypr/conf/animation.conf might contain:

source = ~/.config/hypr/conf/animations/animations-dynamic.conf

This line tells Hyprland to load the animation settings defined in animations-dynamic.conf.

Animation Presets

HyprL comes with several animation presets, each offering a different feel and performance impact.

Switching Presets

You can switch between animation presets by modifying the source line in ~/.config/hypr/conf/animation.conf to point to your desired preset file. In the future, the hyprL-config tool will likely include an option for this.

After changing the source line, remember to reload your Hyprland configuration:

hyprctl reload

Available Presets

The animation preset files are located in ~/.config/hypr/conf/animations/. Some of the available presets include:

  • animations-dynamic.conf: (Often default) Balanced and fluid animations.
  • default.conf: A basic set of animations.
  • disabled.conf: Disables most animations for maximum performance.

Each of these files contains a animations { ... } block with specific settings for various animation properties like bezier curves, animation types, and speed.

Toggling Animations On/Off

HyprL provides a convenient script to quickly toggle animations on or off without changing your preset.

To toggle animations, use the keybinding $mainMod SHIFT + A or run the script directly:

~/.config/hypr/scripts/toggle-animations.sh

This script checks if animations are currently enabled or disabled and switches their state. Note that if your animation.conf sources disabled.conf, this toggle script might not function as expected, as disabled.conf explicitly sets animations:enabled false.

Customizing Animations

For advanced users, you can create your own animation configurations. Copy an existing preset from ~/.config/hypr/conf/animations/, modify its values, and then update ~/.config/hypr/conf/animation.conf to source your new custom file. You can experiment with bezier curves and animation properties to achieve unique visual effects.