01. Overview & Architecture

Profile: v0.56.2
Purpose
Official dynamic tiling Wayland compositor that doesn't sacrifice on the looks.
Compatibility
Arch Linux, NixOS, Fedora, openSUSE (Server: WAYLAND)
Desktop Part
WM & compositors
Window Manager & Theme
Hyprland / Hyprland Cyan & Charcoal
Key Components
Bar: Waybar•Terminal: Kitty•Launcher: Wofi / Rofi-wayland•Notifications: Dunst•Editor: Neovim
Full Description
The reference configuration for Hyprland: dynamic tiling, fluid bezier curves, rounded borders, GPU-accelerated blur, and comprehensive IPC controls. Serves as the high-performance foundation for modern Wayland desktops.
Architecture & Technical Design

The reference configuration for Hyprland: dynamic tiling, fluid bezier curves, rounded borders, GPU-accelerated blur, and comprehensive IPC controls. Serves as the high-performance foundation for modern Wayland desktops.

02. Installation & Deployment

Method: Verified Command

Step-by-step deployment protocol

Step-by-step deployment
1Install Hyprland & Waybar
$sudo pacman -S --needed hyprland waybar kitty wofi
2Set up basic ~/.config/hypr/hyprland.conf
$mkdir -p ~/.config/hypr
$cp /usr/share/hyprland/hyprland.conf ~/.config/hypr/
3Live reload compositor
$hyprctl reload

03. Screenshot Gallery // Hyprland Reference Compositor

Capture 01 // Fullscreen
Hyprland official anime minimalist backdrop
01 / 06

04. Documentation & Guide

Source: hyprwm/HyprlandRef: c7216a9807
README.md|GitHub Flavored Markdown
banner

![Badge Workflow] ![Badge License] Badge Language ![Badge Pull Requests] ![Badge Issues] Badge Hi Mom


Hyprland is a 100% independent, dynamic tiling Wayland compositor that doesn't sacrifice on its looks.

It provides the latest Wayland features, is highly customizable, has all the eyecandy, the most powerful plugins, easy IPC, much more QoL stuff than other compositors and more...


 
 Install 
 
   
 Quick Start 
 
   
 Configure 
 
   
 Contribute 
 



Features

  • All of the eyecandy: gradient borders, many types of blur, animations, glow, shadows and much more
  • A lot of customization
  • 100% independent, no wlroots, no libweston, no kwin, no mutter.
  • Custom bezier and spring curves for the best animations
  • Powerful plugin support
  • Built-in plugin manager
  • Tearing support for better gaming performance
  • Easily expandable and readable codebase
  • Fast and active development
  • Not afraid to provide bleeding-edge features
  • Config reloaded instantly upon saving
  • Global keybinds passed to your apps of choice
  • Tiling/pseudotiling/floating/fullscreen windows
  • Special workspaces (scratchpads)
  • Window groups (tabbed mode)
  • Powerful window/monitor/layer rules
  • Socket-based IPC
  • Native IME and Input Panels Support
  • Fully dynamic workspaces
  • Extensive layout support
    • Dwindle
    • Scrolling
    • Master
    • Monocle
    • Custom layout with Lua
    • Custom layouts with plugins
  • Per Workspace Layouts
  • and much more...


Gallery


Preview A


Preview B


Preview C



Special Thanks


wlroots - For powering Hyprland in the past

tinywl - For showing how 2 do stuff

Sway - For showing how 2 do stuff the overkill way

Vivarium - For showing how 2 do stuff the simple way

dwl - For showing how 2 do stuff the hacky way

Wayfire - For showing how 2 do some graphics stuff

GitHub Flavored Markdown (github-markdown-css)● Live Repo Synced

05. Keyboard Shortcuts

Total: 4 shortcuts
SUPER + QShortcut
exec, kitty
Open terminal
SUPER + CShortcut
killactive
Close window
SUPER + MShortcut
exit
Exit Hyprland session
SUPER + VShortcut
togglefloating
Toggle window floating