Repolode
hyprwm

hyprwm/Hyprland

Hyprland is an independent, dynamic tiling Wayland compositor with extensive visual effects, customization, and a plugin system.

Stars
40,481
Forks
2,166
Open issues
193
Last commit
yesterday

What is it?

Hyprland is a Wayland compositor, the component that manages windows and draws the desktop on Linux systems using the Wayland display protocol. It arranges windows automatically in a tiling layout while also supporting floating and fullscreen windows, and it is built from its own codebase rather than on top of wlroots, libweston, KWin, or Mutter.

The project focuses on appearance and configurability. It offers gradient borders, several blur types, animations with custom bezier and spring curves, glow and shadow effects, and per-workspace layouts including Dwindle, Scrolling, Master, and Monocle. Users can write custom layouts in Lua or through plugins, and a built-in plugin manager is included. Configuration reloads as soon as the file is saved.

Other features include special workspaces used as scratchpads, window groups in tabbed mode, window, monitor, and layer rules, socket-based IPC, native input method (IME) support, and tearing support for gaming.

Key features

  • 01Gradient borders, multiple blur types, animations, glow, and shadow effects.
  • 02Custom bezier and spring animation curves.
  • 03Multiple layouts including Dwindle, Scrolling, Master, and Monocle, with per-workspace settings.
  • 04Custom layouts through Lua or plugins, with a built-in plugin manager.
  • 05Configuration reloads instantly on save.
  • 06Socket-based IPC and native input method support.

Use cases

  • Running a visually customized tiling desktop on Linux with Wayland.
  • Scripting window management through IPC or Lua.
  • Gaming on Linux with tearing support enabled.
  • Building or testing custom compositor layouts and plugins.

Quick start

  1. 1

    Read the installation guide on the project wiki

  2. 2

    Follow the quick start tutorial to run Hyprland

Things to know

  • Requires a Linux system with Wayland; it is not a cross-platform tool.
  • Installation is not a single package-manager command in the README, so setup takes some effort.

In collections

Topics

FAQ

What is Hyprland?
Hyprland is an independent, dynamic tiling Wayland compositor with extensive visual effects, customization, and a plugin system. Hyprland is a Wayland compositor, the component that manages windows and draws the desktop on Linux systems using the Wayland display protocol. It arranges windows automatically in a tiling layout while also supporting floating and fullscreen windows, and it is built from its own codebase rather than on top of wlroots, libweston, KWin, or Mutter.
Is Hyprland free to use? What license does it have?
Hyprland is open source under the BSD-3-Clause license. Check the license terms before using it in commercial products.
Is Hyprland still maintained?
Actively maintained. The last commit to Hyprland was on Nov 6, 2026.
What can I use Hyprland for?
Running a visually customized tiling desktop on Linux with Wayland. Scripting window management through IPC or Lua. Gaming on Linux with tearing support enabled. Building or testing custom compositor layouts and plugins.
How do I install Hyprland?
Read the installation guide on the project wiki Follow the quick start tutorial to run Hyprland
Where can I get Hyprland?
The source code and installation instructions are on GitHub: https://github.com/hyprwm/Hyprland

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects