A Wayland compositor for daily desktop use, with scrolling, dwindle, master and stacking layouts, per-output workspaces, blur and animations.
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
Read the installation guide on the project wiki
- 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
A highly customizable status bar for Wayland compositors such as Sway, Hyprland and river, with modules for system, network and audio status.
A freedesktop notification daemon for Wayland compositors, drawing themed notification cards with the Rune Rust UI framework.
A fully customizable desktop environment for Windows 10/11 that replaces the taskbar, dock, launcher, and window manager with themeable components.
A highly customizable macOS status bar replacement, configured with shell scripts and driven by events.
A customization marketplace for Windows programs that lets users install and manage community-made mods to change how apps behave.