Hyprland - Revision history

Pigeon: /* Swaylock */ also mention Waylock in the troubleshooting tip (there is no mention of this fix for waylock on nixos wiki)

2026-03-08T23:48:12Z

Swaylock: also mention Waylock in the troubleshooting tip (there is no mention of this fix for waylock on nixos wiki)

← Older revision		Revision as of 23:48, 8 March 2026
Line 224:		Line 224:
	[https://github.com/hyprland-community/awesome-hyprland#plugins List of plugins]		[https://github.com/hyprland-community/awesome-hyprland#plugins List of plugins]
	== Troubleshooting ==		== Troubleshooting ==
	=== Swaylock ===		=== Swaylock/Waylock ===
	If swaylock cannot be unlocked with the correct password:		If swaylock/waylock cannot be unlocked with the correct password:

	<code>		<code>
	security.pam.services.swaylock = {};		security.pam.services.swaylock = {};</code>(or <code>waylock</code> repsectively)
	</code>

	=== Electron applications defaulting to X11 rather than Wayland ===		=== Electron applications defaulting to X11 rather than Wayland ===

RhenCloud at 14:18, 11 February 2026

2026-02-11T14:18:23Z

← Older revision		Revision as of 14:18, 11 February 2026
Line 1:		Line 1:
			<translate>
	[https://hyprland.org/ Hyprland] is an independent, extensible, bleeding-edge [[Wayland]] compositor written in modern C++ with an emphasis on looks. In addition, Hyprland also offers a number of first-party tools as well as a custom plugin system. The most up-to-date and complete documentation may be found on the project's own [https://wiki.hyprland.org/ wiki].		[https://hyprland.org/ Hyprland] is an independent, extensible, bleeding-edge [[Wayland]] compositor written in modern C++ with an emphasis on looks. In addition, Hyprland also offers a number of first-party tools as well as a custom plugin system. The most up-to-date and complete documentation may be found on the project's own [https://wiki.hyprland.org/ wiki].

Line 285:		Line 286:
	* [https://github.com/hyprwm/Hyprland/ Hyprland Github Page]		* [https://github.com/hyprwm/Hyprland/ Hyprland Github Page]
	* [https://github.com/hyprland-community/awesome-hyprland Community-maintained list of tools, plugins and extensions]		* [https://github.com/hyprland-community/awesome-hyprland Community-maintained list of tools, plugins and extensions]
			</translate>

	[[Category:Window managers]]		[[Category:Window managers]]
	[[Category:Applications]]		[[Category:Applications]]
	[[Category:Hyprland]]		[[Category:Hyprland]]

Klinger: Category:Hyprland

2025-12-28T12:30:09Z

Category:Hyprland

← Older revision		Revision as of 12:30, 28 December 2025
Line 288:		Line 288:
	[[Category:Window managers]]		[[Category:Window managers]]
	[[Category:Applications]]		[[Category:Applications]]
			[[Category:Hyprland]]

Phobos: Updates

2025-12-13T04:23:46Z

Updates

← Older revision		Revision as of 04:23, 13 December 2025
Line 1:		Line 1:
	[https://hyprland.org/ Hyprland] is an independent, extensible, bleeding-edge [[Wayland]] compositor written in modern C++ with an emphasis on looks. In addition, Hyprland also offers a number of first-party tools as well as a custom plugin system. The most up-to-date and complete documentation ~~can~~ be found in the project's own [https://wiki.hyprland.org/ wiki].		[https://hyprland.org/ Hyprland] is an independent, extensible, bleeding-edge [[Wayland]] compositor written in modern C++ with an emphasis on looks. In addition, Hyprland also offers a number of first-party tools as well as a custom plugin system. The most up-to-date and complete documentation may be found on the project's own [https://wiki.hyprland.org/ wiki].

	Some of the most notable features of Hyprland are:		Some of the most notable features of Hyprland are:
	* '''Independent Wayland implementation''': ~~does~~ not rely on wlroots or other external libraries and provides in-house alternatives to common components (screen locking, idle daemon, etc).		* '''Independent Wayland implementation''': Does not rely on wlroots or other external libraries, and provides an in-house alternatives to common components (screen locking, idle daemon, etc).
	* '''Easy to configure''': ~~uses~~ a live reloading config file in plain-text with useful defaults.		* '''Easy to configure''': Uses a live reloading config file in plain-text with useful defaults.
	* '''Dynamic tiling support''': ~~supports~~ both automatic tiling and floating mode with multiple layouts.		* '''Dynamic tiling support''': Supports both automatic tiling and floating mode with multiple layouts.
	* '''Socket-based IPC''': ~~allows~~ controlling the compositor at runtime via UNIX socket.		* '''Socket-based IPC''': Allows controlling the compositor at runtime via UNIX socket.
	* '''Global shortcuts''': ~~permits~~ setting global keybinds for any application (for apps such as [[OBS Studio]]).		* '''Global shortcuts''': Permits setting global keybinds for any application (for apps such as [[OBS Studio]]).
	* '''Window/Workspace Rules''': ~~set~~ special behaviors for certain windows and workspaces.		* '''Window/Workspace Rules''': Set special behaviors for certain windows and workspaces.

	== Installation ==		== Installation ==
Line 141:		Line 141:

	=== Using [[Home Manager]] ===		=== Using [[Home Manager]] ===
	Home Manager allows for declarative configuration of Hyprland using Nix syntax.		Home Manager allows for declarative configuration of Hyprland using Nix syntax. Entries with the same key should be written as lists. Variables’ and colors’ names should be quoted.

	{{~~file\|\|~~\|3={		Find additional options under [https://home-manager.dev/manual/23.11/options.xhtml#opt-wayland.windowManager.hyprland.enable Home Manager - wayland.windowManager.hyprland]. Also, see the [https://wiki.hypr.land/Nix/Hyprland-on-Home-Manager/ Hyprland Page for Home Manager] for more examples.
	wayland.windowManager.hyprland.settings = {
			{{File\|3=wayland.windowManager.hyprland = {
			systemd.enable = false;
			settings = {
	decoration = {		decoration = {
	shadow_offset = "0 5";		shadow_offset = "0 5";
Line 151:		Line 154:

	"$mod" = "SUPER";		"$mod" = "SUPER";

			bind = [
			# Execute Rofi with only the SUPER key
			"$mod, Super_L, exec, pkill rofi {{!}}{{!}} rofi -show drun"

			"$mod, F, exec, librewolf"

			"CONTROL ALT, T, exec, wezterm"
			];

			# Startup Apps
			exec-once = [
			"hyprpanel"
			];

	bindm = [		bindm = [
Line 159:		Line 176:
	];		];
	};		};
	~~# ...~~		};\|name=/etc/nixos/home.nix\|lang=nix}}
	}\|name=/etc/nixos~~/home.nix or ~/.config/home-manager~~/home.nix\|lang=nix}}

	== Plugin Support ==		== Plugin Support ==
Line 167:		Line 183:
	The [[Home Manager]] module for Hyprland should be used instead:		The [[Home Manager]] module for Hyprland should be used instead:

	{{~~file~~\|~~/etc/nixos/home.nix or ~/.config/home-manager/home.nix\|nix\|<nowiki>~~		{{File\|3={
	{
	wayland.windowManager.hyprland.plugins = [		wayland.windowManager.hyprland.plugins = [
	pkgs.hyprlandPlugins.PLUGIN_NAME		pkgs.hyprlandPlugins.PLUGIN_NAME
	];		];
	}		}\|name=/etc/nixos/home.nix\|lang=nix}}
	</~~nowiki>~~}}

	~~=== hyprland-plugins ===~~		[https://github.com/hyprwm/hyprland-plugins hyprland-plugins] is a repository of first-party plugins. If you wish to use these plugins it is recommended to use the Hyprland flake instead of the Nixpkgs version, and to use the [[Home Manager]] module for configuration.
	[https://github.com/hyprwm/hyprland-plugins hyprland-plugins] is a repository of first-party plugins. If you wish to use these plugins ~~then~~ it's recommended to use the Hyprland flake instead of the Nixpkgs version ~~as well as using~~ the [[Home Manager]] module.

	Add the flake to your flake inputs:		Add the flake into your flake inputs:
	{{file\|flake.nix\|nix\|<nowiki>		{{file\|flake.nix\|nix\|<nowiki>
	{		{
Line 194:		Line 207:
	</nowiki>}}		</nowiki>}}

	~~And then~~ add the plugin using the hyprland-plugins input:		Then, add the plugin using the hyprland-plugins input:

	{{file\|/etc/nixos/home.nix or ~/.config/home-manager/home.nix\|nix\|<nowiki>		{{file\|/etc/nixos/home.nix or ~/.config/home-manager/home.nix\|nix\|<nowiki>

Phobos at 03:28, 13 December 2025

2025-12-13T03:28:17Z

← Older revision		Revision as of 03:28, 13 December 2025
Line 10:		Line 10:

	== Installation ==		== Installation ==
	NixOS 24.11 added support for launching Hyprland with [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] (UWSM) and is the recommended way to launch Hyprland as it neatly integrates with [[Systemd]]. [[UWSM\|Options for configuring UWSM may be found here]].		NixOS 24.11 added support for launching Hyprland with [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] (UWSM) and is the recommended way to launch Hyprland as it neatly integrates with [[Systemd]]. [[UWSM\|Options for configuring UWSM may be found here]]. Also see the Hyprland wiki [https://wiki.hypr.land/Useful-Utilities/Systemd-start/#uwsm page for UWSM here].

	{{file\|\|\|<nowiki>		{{file\|\|\|<nowiki>

Phobos: Added link for UWSM Page, added warning for home manager module

2025-12-13T03:26:17Z

Added link for UWSM Page, added warning for home manager module

← Older revision		Revision as of 03:26, 13 December 2025
Line 10:		Line 10:

	== Installation ==		== Installation ==
	NixOS 24.11 added support for launching Hyprland with [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] (UWSM) and is the recommended way to launch Hyprland as it neatly integrates with [[Systemd]].		NixOS 24.11 added support for launching Hyprland with [https://github.com/Vladimir-csp/uwsm Universal Wayland Session Manager] (UWSM) and is the recommended way to launch Hyprland as it neatly integrates with [[Systemd]]. [[UWSM\|Options for configuring UWSM may be found here]].

	{{file\|~~configuration.nix~~\|~~nix~~\|<nowiki>		{{file\|\|\|<nowiki>
	{		{
	programs.hyprland = {		programs.hyprland = {
Line 20:		Line 20:
	};		};
	}		}
	</nowiki>}}		</nowiki>\|name=/etc/nixos/configuration.nix\|lang=nix}}{{Warning\|If you use the Home Manager module, make sure to disable systemd integration, as it conflicts with UWSM.
			</br>
			{{File\|3=wayland.windowManager.hyprland.systemd.enable = false;
			\|name=/etc/nixos/home.nix\|lang=nix}}}}

	=== Nix on Non-NixOS Systems ===		=== Nix on Non-NixOS Systems ===
Line 140:		Line 143:
	Home Manager allows for declarative configuration of Hyprland using Nix syntax.		Home Manager allows for declarative configuration of Hyprland using Nix syntax.

	{{file\|~~/etc/nixos/home.nix or ~/.config/home-manager/home.nix~~\|~~nix~~\|~~<nowiki>~~		{{file\|\|\|3={
	{
	wayland.windowManager.hyprland.settings = {		wayland.windowManager.hyprland.settings = {
	decoration = {		decoration = {
Line 158:		Line 160:
	};		};
	# ...		# ...
	}		}\|name=/etc/nixos/home.nix or ~/.config/home-manager/home.nix\|lang=nix}}
	</~~nowiki>~~}}

	== Plugin Support ==		== Plugin Support ==

Railwhale: Add links to display manager wiki pages (but only greetd exists right now)

2025-12-11T07:56:26Z

Add links to display manager wiki pages (but only greetd exists right now)

← Older revision		Revision as of 07:56, 11 December 2025
Line 129:		Line 129:
	=== Display Manager Support ===		=== Display Manager Support ===
	By default, Hyprland does not come with a [https://wiki.nixos.org/wiki/Wayland#Display_Managers display manager] and does not advertise support for one. Though one can start hyprland directly from tty with <code>Hyprland</code> or with <code>uwsm start select</code>, some display managers packaged in NixOS are compatible including but may not be limited to:		By default, Hyprland does not come with a [https://wiki.nixos.org/wiki/Wayland#Display_Managers display manager] and does not advertise support for one. Though one can start hyprland directly from tty with <code>Hyprland</code> or with <code>uwsm start select</code>, some display managers packaged in NixOS are compatible including but may not be limited to:
	* SDDM		* [[SDDM]]
	* GDM (works but crashes Hyprland on first launch)		* [[GDM]] (works but crashes Hyprland on first launch)
	* ~~greetd~~ (especially with ReGreet)		* [[Greetd]] (especially with ReGreet)
	* ly (not recommended but works)		* [[Ly]] (not recommended but works)

	== Configuration ==		== Configuration ==

Mlaga97: Update deprecated use of `mesa.drivers` to `mesa`

2025-12-07T18:59:14Z

Update deprecated use of `mesa.drivers` to `mesa`

← Older revision		Revision as of 18:59, 7 December 2025
Line 90:		Line 90:
	If you experience performance drops in video games or graphics tools like Blender on stable NixOS, then it's likely a [[Mesa]] version mismatch with Hyprland and the rest of your system. This can be fixed by substituting the system's mesa package with Hyprland's own.		If you experience performance drops in video games or graphics tools like Blender on stable NixOS, then it's likely a [[Mesa]] version mismatch with Hyprland and the rest of your system. This can be fixed by substituting the system's mesa package with Hyprland's own.

	{{file\|~~configuration.nix\|nix\|~~<nowiki>		{{file\|3=<nowiki>
	{pkgs, inputs, ...}: let		{pkgs, inputs, ...}: let
	pkgs-unstable = inputs.hyprland.inputs.nixpkgs.legacyPackages.${pkgs.stdenv.hostPlatform.system};		pkgs-unstable = inputs.hyprland.inputs.nixpkgs.legacyPackages.${pkgs.stdenv.hostPlatform.system};
	in {		in {
	hardware.graphics = {		hardware.graphics = {
	package = pkgs-unstable.mesa~~.drivers~~;		package = pkgs-unstable.mesa;

	# if you also want 32-bit support (e.g for Steam)		# if you also want 32-bit support (e.g for Steam)
	enable32Bit = true;		enable32Bit = true;
	package32 = pkgs-unstable.pkgsi686Linux.mesa~~.drivers~~;		package32 = pkgs-unstable.pkgsi686Linux.mesa;
	};		};
	}		}
	</nowiki>}}		</nowiki>\|name=configuration.nix\|lang=nix}}

	==== Cachix ====		==== Cachix ====

Phobos: added link

2025-12-05T20:24:45Z

added link

← Older revision		Revision as of 20:24, 5 December 2025
Line 47:		Line 47:
	* '''hyprlock''': Hyprland's GPU-accelerated screen locking utility.		* '''hyprlock''': Hyprland's GPU-accelerated screen locking utility.
	* '''hypridle''': Hyprland's idle daemon.		* '''hypridle''': Hyprland's idle daemon.
	* ~~'''~~hyprpaper~~'''~~: Hyprland's wallpaper utility.		* [[hyprpaper]]: Hyprland's wallpaper utility.
	* '''hyprsunset''': Application to enable a blue-light filter on Hyprland.		* '''hyprsunset''': Application to enable a blue-light filter on Hyprland.
	* '''hyprpicker''': Wayland color picker that does not suck.		* '''hyprpicker''': Wayland color picker that does not suck.

LucasFA: /* Hyprland Flake */ Update for the hardware.opengl -> hardware.graphics migration

2025-10-26T17:39:30Z

Hyprland Flake: Update for the hardware.opengl -> hardware.graphics migration

← Older revision		Revision as of 17:39, 26 October 2025
Line 88:		Line 88:
	</nowiki>}}		</nowiki>}}

	If you experience performance drops in video games or graphics tools like Blender on stable NixOS, then it's likely a [[Mesa]] version mismatch with Hyprland and the rest of your system. This can be fixed by substituting the system's mesa package with Hyprland's own. ~~'''Note that the''' <code>hardware.opengl</code> '''option only exists 24.05 and below'''.~~		If you experience performance drops in video games or graphics tools like Blender on stable NixOS, then it's likely a [[Mesa]] version mismatch with Hyprland and the rest of your system. This can be fixed by substituting the system's mesa package with Hyprland's own.

	{{file\|configuration.nix\|nix\|<nowiki>		{{file\|configuration.nix\|nix\|<nowiki>
Line 94:		Line 94:
	pkgs-unstable = inputs.hyprland.inputs.nixpkgs.legacyPackages.${pkgs.stdenv.hostPlatform.system};		pkgs-unstable = inputs.hyprland.inputs.nixpkgs.legacyPackages.${pkgs.stdenv.hostPlatform.system};
	in {		in {
	hardware.~~opengl~~ = {		hardware.graphics = {
	package = pkgs-unstable.mesa.drivers;		package = pkgs-unstable.mesa.drivers;

	# if you also want 32-bit support (e.g for Steam)		# if you also want 32-bit support (e.g for Steam)
	~~driSupport32Bit~~ = true;		enable32Bit = true;
	package32 = pkgs-unstable.pkgsi686Linux.mesa.drivers;		package32 = pkgs-unstable.pkgsi686Linux.mesa.drivers;
	};		};