# Hyprland | Hypr Development | Knowledge Base | Instagit

Hyprland is an independent, highly customizable, dynamic tiling Wayland compositor that doesn't sacrifice on its looks.

GitHub Stars: 37.3k

Repository: https://github.com/hyprwm/Hyprland

---

## Articles

### [How to Configure Hyprland Autostart Applications: A Complete Guide](/hyprwm/Hyprland/how-to-configure-hyprlands-autostart-applications)

Learn how to configure Hyprland autostart applications using the exec-once directive in hyprland.conf. This guide explains the process for seamless startup.

- Tags: how-to-guide
- Published: 2026-07-29

### [The Role of Wayland in Hyprland: Protocol Implementation and Architecture](/hyprwm/Hyprland/what-is-the-role-of-wayland-in-hyprland)

Discover how Wayland acts as the core protocol and communication backbone for Hyprland, managing surfaces, input, and client connections for this dynamic tiling compositor.

- Tags: architecture
- Published: 2026-07-29

### [How to Report a Bug in Hyprland: A Complete Guide with Logs and Crash Reports](/hyprwm/Hyprland/how-to-report-a-bug-in-hyprland)

Effectively report Hyprland bugs. Learn to gather logs, attach config files, and include crash reports to help developers resolve issues faster. Find out how to report bugs in Hyprland today.

- Tags: how-to-guide
- Published: 2026-07-29

### [Advantages of Using Hyprland: Why This Independent Wayland Compositor Stands Out](/hyprwm/Hyprland/what-are-the-advantages-of-using-hyprland)

Discover the advantages of Hyprland a high-performance Wayland compositor offering dynamic tiling animations and a C++ plugin system. Enjoy instant config reloads and socket-based IPC with this independent solution.

- Tags: deep-dive
- Published: 2026-07-29

### [How to Use Hyprland Animation Features: A Complete Guide to Workspace and Window Effects](/hyprwm/Hyprland/how-to-use-hyprlands-animation-features)

Master Hyprland animation features to add workspace transitions and window effects like slide and fade. Customize animations with speeds and bezier curves for a dynamic desktop.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Customize the Hyprland Status Bar: Complete Waybar Setup Guide](/hyprwm/Hyprland/how-to-customize-the-hyprland-status-bar)

Learn how to customize your Hyprland status bar with Waybar. This guide explains the JSON and CSS configuration needed to set up your custom bar.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Build Hyprland from Source: Complete Installation Guide](/hyprwm/Hyprland/how-to-build-hyprland-from-source)

Build Hyprland from source with our comprehensive guide. Learn to install dependencies, compile, and configure Hyprland for a custom Wayland experience.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Programming Language Is Hyprland Written In? Inside the C++20 Wayland Codebase](/hyprwm/Hyprland/what-programming-language-is-hyprland-written-in)

Discover the programming language behind Hyprland. Explore the C++20 Wayland compositor and its modern codebase. Understand the technology driving this dynamic window manager.

- Tags: internals
- Published: 2026-07-29

### [Where to Find Hyprland Themes and Plugins: A Complete Guide](/hyprwm/Hyprland/where-can-i-find-hyprland-themes-and-plugins)

Discover where to find Hyprland themes and plugins. Learn how to enhance your desktop with custom looks and powerful extensions for the Hyprland window manager.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Troubleshoot Hyprland Startup Issues: A Complete Technical Guide](/hyprwm/Hyprland/how-to-troubleshoot-hyprland-startup-issues)

Directly troubleshoot Hyprland startup failures. Learn to check XDG_RUNTIME_DIR permissions, verify configs, use safe mode, and analyze debug logs for a smooth desktop experience.

- Tags: how-to-guide
- Published: 2026-07-29

### [What Are the Most Common Hyprland Commands? A Complete hyprctl Reference](/hyprwm/Hyprland/what-are-the-most-common-hyprland-commands)

Master Hyprland with essential hyprctl commands. Explore dispatch, keyword, reload, kill, monitors, workspaces, and clients for efficient Wayland control. Get the complete reference.

- Tags: api-reference
- Published: 2026-07-29

### [How to Create Custom Hyprland Rules for Specific Applications](/hyprwm/Hyprland/how-to-create-custom-hyprland-rules-for-specific-applications)

Learn to create custom Hyprland rules for specific applications. Automate floating states, opacity, monitor placement & more using windowrule syntax for a personalized workflow.

- Tags: how-to-guide
- Published: 2026-07-29

### [How to Set Up Multiple Monitors with Hyprland: A Complete Configuration Guide](/hyprwm/Hyprland/how-to-set-up-multiple-monitors-with-hyprland)

Easily set up multiple monitors with Hyprland. Learn to configure displays in hyprland.lua by defining hl monitor blocks for resolutions positions and scales to create your ideal virtual desktop.

- Tags: how-to-guide
- Published: 2026-07-29

### [Difference Between Hyprland and Sway: Architecture and Feature Comparison](/hyprwm/Hyprland/what-is-the-difference-between-hyprland-and-sway)

Discover the key differences between Hyprland and Sway. Explore Hyprland's C++20 stack and Aquamarine backend versus Sway's wlroots library and i3 compatibility to choose your ideal tiling window manager.

- Tags: comparison
- Published: 2026-07-29

### [How to Configure Hyprland Keybindings: A Complete Guide to the binds Section](/hyprwm/Hyprland/how-to-configure-hyprland-keybindings)

Master Hyprland keybindings by configuring the binds section in hyprland.conf. Learn to map key combinations to actions for efficient workflow control.

- Tags: how-to-guide
- Published: 2026-07-29

### [Minimum System Requirements for Hyprland: Complete Hardware and Software Specs](/hyprwm/Hyprland/what-are-the-minimum-system-requirements-for-hyprland)

Discover Hyprland minimum system requirements including Linux kernel, Wayland, OpenGL, and C++ compiler specs. Get your system ready for Hyprland today.

- Tags: minimum-system-requirements
- Published: 2026-07-29

### [How to Install Hyprland on Arch Linux: Complete Setup Guide](/hyprwm/Hyprland/how-to-install-hyprland-on-arch-linux)

Learn to install Hyprland on Arch Linux with our easy guide. Configure and launch this dynamic Wayland compositor in minutes for a superior desktop experience.

- Tags: getting-started
- Published: 2026-07-29

### [Complete Hyprland HDR Support Setup Guide](/hyprwm/Hyprland/hyprland-hdr-support-setup)

Master Hyprland HDR support setup with this guide. Enable quirks:prefer_hdr and render:cm_auto_hdr for automatic HDR switching. Get vibrant visuals now.

- Tags: how-to-guide
- Published: 2026-07-27

### [Hyprland Fullscreen Mode Configuration: A Complete Guide to Controllers, Handlers, and Layout Rules](/hyprwm/Hyprland/hyprland-fullscreen-mode-configuration)

Master Hyprland fullscreen mode configuration. Explore controllers, handlers, and layout rules to optimize your window management. Get the complete guide now.

- Tags: how-to-guide
- Published: 2026-07-27

### [How Hyprland Layer Surfaces Work: Wayland Protocol Implementation Guide](/hyprwm/Hyprland/how-do-hyprland-layer-surfaces-work)

Understand Hyprland layer surfaces, Wayland protocol implementations for composited rendering and input. Explore CLayerSurface objects and monitor-specific vectors.

- Tags: deep-dive
- Published: 2026-07-27

### [How Hyprland Screencasting Permissions Work: Dynamic Permission System Explained](/hyprwm/Hyprland/hyprland-screencasting-permissions)

Understand Hyprland screencasting permissions. Learn how the dynamic permission system manages Wayland screencopy requests with configurable Lua rules.

- Tags: internals
- Published: 2026-07-27

### [Hyprland Session Lock Manager Usage: Protocol Architecture and Examples](/hyprwm/Hyprland/hyprland-session-lock-manager-usage)

Learn to use Hyprland's session lock manager protocol. Discover how to lock sessions, manage per-monitor surfaces, and handle lock/unlock notifications with clear examples.

- Tags: how-to-guide
- Published: 2026-07-27

### [Hyprland VRR Configuration: Enabling Variable Refresh Rate Per-Monitor and Globally](/hyprwm/Hyprland/hyprland-vrr-configuration)

Master Hyprland VRR configuration to enable Variable Refresh Rate per monitor or globally. Optimize your display performance with this essential guide.

- Tags: how-to-guide
- Published: 2026-07-27

### [Hyprland Tearing Control for Gaming: How Low-Latency Rendering Works](/hyprwm/Hyprland/hyprland-tearing-control-for-gaming)

Optimize Hyprland tearing control for gaming. Discover how low-latency rendering eliminates screen tearing for a smoother, more responsive experience.

- Tags: tutorial
- Published: 2026-07-27

### [Hyprland Per-Monitor Workspace Assignment: A Deep Dive into the Source Code](/hyprwm/Hyprland/hyprland-per-monitor-workspace-assignment)

Explore Hyprland's per-monitor workspace assignment by diving into the source code. Understand how rules, placement controllers, and monitor pointers manage workspaces for a seamless workflow.

- Tags: deep-dive
- Published: 2026-07-27

### [How Hyprland Workspace Rules Work: Parsing, Storage, and Runtime Enforcement](/hyprwm/Hyprland/how-do-hyprland-workspace-rules-work)

Understand Hyprland workspace rules. Learn how parsing, storage, and runtime enforcement of rules bind workspaces to monitors and configure attributes for a streamlined workflow.

- Tags: internals
- Published: 2026-07-27

### [How to Set Up Hyprland Window Grouping (Tabbed Mode)](/hyprwm/Hyprland/hyprland-window-grouping-tabbed-mode-setup)

Learn to set up Hyprland window grouping tabbed mode with easy steps. Organize your workspace efficiently and boost productivity. Master Hyprland's tabbed layout today.

- Tags: how-to-guide
- Published: 2026-07-26

### [Hyprland Trackpad Gesture Configuration: Complete Technical Guide](/hyprwm/Hyprland/hyprland-trackpad-gesture-configuration)

Master Hyprland trackpad gesture configuration with this technical guide. Learn how Hyprland handles swipe and pinch events using Wayland protocols and customize your gestures in hyprland.conf for an optimized workflow.

- Tags: how-to-guide
- Published: 2026-07-26

### [Configuring Hyprland Keybinds and Input Events: A Complete Technical Guide](/hyprwm/Hyprland/configuring-hyprland-keybinds-and-input-events)

Master Hyprland keybinds and input events with this complete guide. Learn to configure binds from hyprland.conf and understand raw input event handling for seamless workflow customization.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Run X11 Apps with Hyprland XWayland: Complete Configuration Guide](/hyprwm/Hyprland/how-to-run-x11-apps-with-hyprland-xwayland)

Easily run X11 apps with Hyprland XWayland. This guide covers complete configuration for seamless integration, scaling, clipboard support, and coordinate translation on your Wayland desktop.

- Tags: how-to-guide
- Published: 2026-07-26

### [Hyprland XWayland Integration: Architecture, Lifecycle, and Configuration](/hyprwm/Hyprland/hyprland-xwayland-integration-details)

Explore Hyprland XWayland integration architecture. Learn about its lifecycle, configuration, and how it bridges X11 apps to Wayland for seamless compatibility. Optimize your setup now.

- Tags: architecture
- Published: 2026-07-26

### [Complete List of Hyprland IPC Socket Events: Reference and Usage Guide](/hyprwm/Hyprland/available-events-for-hyprland-ipc-socket)

Explore Hyprland IPC socket events. Discover over 30 event types like workspace, window, monitor, and input events for detailed compositor state changes. Master Hyprland customization.

- Tags: api-reference
- Published: 2026-07-26

### [Hyprland IPC Socket Communication Explained: Event and Command Socket Architecture](/hyprwm/Hyprland/hyprland-ipc-socket-communication-explained)

Master Hyprland IPC socket communication. Learn about event and command sockets for seamless external tool integration without DBus.

- Tags: deep-dive
- Published: 2026-07-26

### [Hyprland Spring Animation Configuration: A Complete Guide to Physics-Based Motion](/hyprwm/Hyprland/hyprland-spring-animation-configuration)

Master Hyprland spring animation configuration. Learn to create physics-based motion with hl.curve mass, stiffness, and dampening for dynamic window effects. Get the complete guide now.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Implement Custom Bézier Curves in Hyprland Animations](/hyprwm/Hyprland/how-to-implement-custom-bezier-curves-in-hyprland-animations)

Learn to implement custom bezier curves in Hyprland animations using the hl.curve() Lua helper. Customize your animations with precise control. Get started now!

- Tags: how-to-guide
- Published: 2026-07-26

### [Difference Between Dwindle, Master, and Monocle Layouts in Hyprland](/hyprwm/Hyprland/difference-between-dwindle-master-monocle-layouts-hyprland)

Explore the differences between Dwindle, Master, and Monocle layouts in Hyprland. Understand how each tiling algorithm arranges windows to optimize your workflow with this guide.

- Tags: deep-dive
- Published: 2026-07-26

### [Hyprland Hot-Desking Configuration: Automatic Workspace-to-Monitor Assignment](/hyprwm/Hyprland/hyprland-hot-desking-configuration)

Master Hyprland hot-desking: Automatically assign workspaces to monitors with simple workspace rules. Effortlessly manage your setup as monitors connect or disconnect.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Create a Hyprland Plugin: Complete Guide to Building Loadable Modules](/hyprwm/Hyprland/how-to-create-a-hyprland-plugin)

Learn to create Hyprland plugins as C++ shared libraries. This guide covers exporting hyprland_load and hyprland_unload functions to register callbacks and commands at runtime.

- Tags: how-to-guide
- Published: 2026-07-26

### [How to Debug Hyprland Window Rule Matching: A Complete Guide](/hyprwm/Hyprland/how-to-debug-hyprland-window-rule-matching)

Debug Hyprland window rule matching with trace logging. Monitor CWindowRuleApplicator logs to understand rule application during static and dynamic evaluation. Solve your Hyprland window rule issues now.

- Tags: how-to-guide
- Published: 2026-07-26

### [How Hyprland's Configuration Hot-Reload System Works with inotify](/hyprwm/Hyprland/hyprland-config-hot-reload-inotify)

Discover how Hyprland's configuration hot-reload uses inotify to automatically update your settings without restarting. Learn about the CConfigWatcher class.

- Tags: internals
- Published: 2026-07-23

### [How Hyprland Implements Color Management and HDR Support: Technical Architecture](/hyprwm/Hyprland/hyprland-color-management-hdr-support)

Discover how Hyprland achieves advanced color management and HDR support. Learn about its Wayland protocol pipeline, EDID parsing, and dynamic HDR mode switching for vibrant visuals.

- Tags: architecture
- Published: 2026-07-23

### [How the Hyprland IPC Socket System Works for Inter‑Process Communication](/hyprwm/Hyprland/how-hyprland-ipc-socket-system-works)

Explore the Hyprland IPC socket system for seamless inter-process communication. Learn how this lightweight UNIX-domain socket layer allows external programs to query compositor state and issue commands efficiently.

- Tags: internals
- Published: 2026-07-23

### [Hyprland Layout Algorithms: Dwindle vs Master Tiling Implementation](/hyprwm/Hyprland/hyprland-layout-algorithms-dwindle-master)

Explore Hyprland's Dwindle vs Master tiling layout algorithms. Learn how these dynamic, configurable tiling options enhance your window management.

- Tags: deep-dive
- Published: 2026-07-23

### [How to Create Custom Window Decorations Using the Hyprland Plugin API](/hyprwm/Hyprland/add-custom-window-decorations-hyprland-plugin-api)

Learn how to create custom window decorations in Hyprland using the Plugin API. Implement IHyprWindowDecoration and register your plugin to enhance your window management experience.

- Tags: how-to-guide
- Published: 2026-07-23

### [How Hyprland Manages Layer Shell Surfaces: A Technical Deep Dive into Bars and Docks](/hyprwm/Hyprland/how-hyprland-manages-layer-shell-surfaces)

Discover how Hyprland manages layer shell surfaces like bars and docks independently of wlroots. Learn about its CLayerShellResource and CLayerSurface classes.

- Tags: deep-dive
- Published: 2026-07-23

### [Hyprland Animation System Explained: How AnimatedVariable Powers Smooth Transitions](/hyprwm/Hyprland/hyprland-animation-system-animatedvariable)

Discover Hyprland's animation system and its AnimatedVariable class. Learn how it creates smooth transitions and repaints windows efficiently.

- Tags: deep-dive
- Published: 2026-07-23

### [How Special Workspaces (Scratchpads) Work in Hyprland: A Deep Dive into the Source Code](/hyprwm/Hyprland/how-hyprland-special-workspaces-scratchpads-work)

Understand Hyprland scratchpads with this deep dive into their source code. Learn how special workspaces use flags, IDs, and isolated rendering to function seamlessly.

- Tags: deep-dive
- Published: 2026-07-23

### [How Hyprland Parses and Applies Workspace Rules: A Deep Dive into the Source Code](/hyprwm/Hyprland/how-hyprland-workspace-rules-parsed-applied)

Discover how Hyprland parses and applies workspace rules. Explore the source code to understand rule management and runtime application for dynamic workspace configurations.

- Tags: deep-dive
- Published: 2026-07-23

### [Hyprland Tiling vs Floating vs Pseudotiling vs Fullscreen: Window Mode Differences Explained](/hyprwm/Hyprland/hyprland-window-modes-difference)

Explore Hyprland's window modes: tiling, floating, pseudotiling, and fullscreen. Understand their unique geometry, rendering, and workspace differences to optimize your workflow.

- Tags: deep-dive
- Published: 2026-07-23

### [Hyprland Plugin System: Architecture, Loading Mechanism, and Runtime Safety](/hyprwm/Hyprland/what-is-hyprland-plugin-system)

Explore the Hyprland plugin system an advanced dynamic shared-library architecture. Learn how it extends the Wayland compositor at runtime with C entry points and fault-isolated hooks.

- Tags: architecture
- Published: 2026-07-23

### [How to Create a Custom Layout in Hyprland: A Complete Lua Guide](/hyprwm/Hyprland/how-to-create-custom-layout-in-hyprland)

Learn to create custom Hyprland layouts with Lua. Register your layout and manipulate windows using ctx:split() and target:place() for ultimate control.

- Tags: how-to-guide
- Published: 2026-07-23

### [How Does Hyprland Manage State Transitions for Windows?](/hyprwm/Hyprland/how-does-hyprland-manage-state-transitions-for-windows)

Discover how Hyprland manages window state transitions with its signal-driven architecture, immutable snapshots, and animation controllers for atomic and deterministic window management.

- Tags: internals
- Published: 2026-07-23

### [How Hyprland Handles Monitors and Display Configurations: A Technical Deep-Dive](/hyprwm/Hyprland/how-does-hyprland-handle-monitors-and-display-configurations)

Discover how Hyprland handles monitors and display configurations. Learn about its CMonitor object, state trackers, and Aquamarine backend integration for seamless display management.

- Tags: deep-dive
- Published: 2026-07-23

### [Where Is the Hyprland IPC Code? A Deep Dive into the EventManager Implementation](/hyprwm/Hyprland/where-is-the-code-for-hyprlands-ipc-inter-process-communication)

Discover where Hyprland's IPC code resides! Explore the EventManager implementation in EventManager cpp and hpp files, and understand how it manages client communication via Unix domain sockets.

- Tags: deep-dive
- Published: 2026-07-23

### [CWindow Data Structure: How Hyprland Represents Windows](/hyprwm/Hyprland/what-is-the-data-structure-for-representing-windows-in-hyprland)

Explore the CWindow data structure in Hyprland. Learn how this core class manages window state, layout, rendering, and input for Wayland and X11 surfaces.

- Tags: internals
- Published: 2026-07-23

### [Where to Find Hyprland's Configuration Parsing Logic: A Complete Guide to the Config System](/hyprwm/Hyprland/where-can-i-find-the-configuration-parsing-logic-in-hyprland)

Discover Hyprland's configuration parsing logic within its Lua interpreter system. Explore key files like ConfigManager.cpp and CConfigManager.cpp for a comprehensive understanding.

- Tags: deep-dive
- Published: 2026-07-23

### [What Is the Role of Core Files in Hyprland? A Wayland Protocol Breakdown](/hyprwm/Hyprland/what-is-the-role-of-core-files-in-hyprland)

Explore Hyprland core files and their role in implementing the Wayland core protocol. Understand how C++ objects bridge client requests for a seamless Wayland experience.

- Tags: internals
- Published: 2026-07-23

### [How X11/Wayland Events Are Processed in Hyprland: A Deep Dive into the Source Code](/hyprwm/Hyprland/how-are-x11-wayland-events-processed-in-hyprland)

Explore how Hyprland processes X11 Wayland events. Learn about wlroots capture, XWM translation, and EventBus broadcasting in this deep source code dive.

- Tags: deep-dive
- Published: 2026-07-23