Skip to Content
MvpDots

Liquid Glass & plugins

Optional Hyprland plugins that rebuild themselves after every Hyprland update.

What they add

PluginWhat you see
hyprglassApple-style Liquid Glass on the bar, island, dock and screenshot toolbar
hyprbarsmacOS traffic-light title bars on floating windows
dynamic-cursorsshake the pointer to make it big and easy to find
hyprfocusa soft pulse on the window you switch to

All optional: without them the desktop looks the same, with normal blur instead of glass.

Settings, Liquid Glass: style, frost, refraction, edge glow and where the glass appears

The problem they solve

A Hyprland plugin is compiled code that runs inside Hyprland, so it must be built against the exact Hyprland version that loads it. That is why plugins usually break after an update. MvpDots handles it for you.

How it works

Pick the right version. Every plugin ships a hyprpm.toml that pairs Hyprland releases with the plugin commit that builds against them, the same data Hyprland's own hyprpm uses:

hyprpm.toml (in each plugin's repository)
[repository]
commit_pins = [
    ["918d8340afd652b011b937d29d5eea0be08467f5", "f0409be76564171a97a792deabab3bd0528fe40c"], # v0.41.2
    # … one line per Hyprland release
]

hypr-plugins reads the installed Hyprland's commit and looks it up:

~/.local/bin/hypr-plugins (excerpt)
hypr_commit() { hyprland_version | grep -oE 'commit [0-9a-f]{40}' | head -1 | cut -d' ' -f2 || true; }

pin_for() {   # repo dir, hyprland commit → plugin commit (empty = newest)
    python3 - "$1/hyprpm.toml" "$2" <<'PY'
import sys, tomllib
pins = tomllib.load(open(sys.argv[1], "rb")).get("repository", {}).get("commit_pins", [])
print(next((p[1] for p in pins if p[0] == sys.argv[2]), ""))
PY
}

Build without sudo against the headers your distro installed with Hyprland (pkg-config hyprland), into ~/.local/lib/hyprland-plugins/, and remember which Hyprland they were built for.

Rebuild after updates. At every login Hyprland runs hypr-plugins auto. If the installed Hyprland differs from the one the plugins were built for, it rebuilds them in the background, reloads, and tells you:

~/.config/hypr/hyprland.lua
-- after a Hyprland update, rebuild the plugins for the new version in the background
hl.on("hyprland.start", function() hl.exec_cmd("hypr-plugins auto") end)
pcall(require, "plugins")

Use it

Terminal
hypr-plugins status   # Hyprland version, and what the plugins were built for
hypr-plugins build    # build now
hypr-plugins off      # remove them (and stop automatic rebuilds)
hypr-plugins on       # build them again
hypr-plugins build
:: Building plugins for Hyprland 0.56.2 (efb5099)
:: hyprglass → pinned 7fc3280
:: hyprglass ✓
:: hypr-dynamic-cursors → pinned 5a22428
:: dynamic-cursors ✓
:: hyprland-plugins → pinned 7644cec
:: hyprfocus ✓
:: hyprbars ✓
:: 4 built. They load at the next login, or now with: hyprctl reload

Safety

  • Each plugin loads inside pcall: if Hyprland refuses one (wrong version), it is skipped and logged to ~/.local/state/hypr/plugin-errors.log.
  • Crash guard: for the first 30 seconds after login a marker file exists. If Hyprland crashes in that window, the next login skips the plugins and tells you. rm ~/.local/state/hypr/plugins-starting to try again.
  • Glass is drawn only on the shell's small floating parts, so a still screen costs nothing.

Tune the glass

Settings → Liquid Glass: style (apple, saneaspect, subtle, clear, glass, high contrast), frost, refraction, lens, edge width, rainbow edge, edge glow, highlight, brightness, contrast, saturation, vibrancy, and where it appears.

On this page