Skip to content

Hyprlax — Smooth Parallax Wallpapers for Hyprland

Hyprlax is a high‑performance parallax wallpaper system for Wayland compositors, designed for buttery‑smooth animations on Hyprland. It creates depth by moving multiple image layers at different speeds, with a modern renderer, runtime control, and strong configurability.

Highlights

  • Multi‑layer parallax with depth and per‑layer controls
  • OpenGL ES 2.0 renderer + Wayland layer‑shell
  • 144 FPS target with optimized render loop
  • Runtime control via hyprlax ctl (add/modify/list at runtime)
  • Works across multiple compositors: Hyprland, Sway, Wayfire, Niri, River
  • Simple legacy config and rich TOML configuration

Quick Start

Already installed? Try these in a terminal:

# Single image (quick smoke test)
hyprlax ~/Pictures/wall.jpg

# Multi‑layer (foreground + background)
hyprlax --debug \
  --layer ~/Pictures/bg.jpg:0.3:1.0 \
  --layer ~/Pictures/fg.png:1.0:0.9

# Runtime control (add a layer while running)
hyprlax ctl add ~/Pictures/overlay.png opacity=0.8 scale=1.2

New to hyprlax? Start with the guides below.

Configure

Hyprlax supports two configuration styles:

Moving from legacy to TOML? See the Migration Guide. You can convert existing configs with:

hyprlax ctl convert-config ~/.config/hyprlax/parallax.conf ~/.config/hyprlax/hyprlax.toml --yes

Environment variables are also supported: see Environment.

Learn by Examples and Guides

Reference

Development