Hyprland - Revision history

Whitebow: Started updating the wiki for Hyprland 0.55 and the replacement of hyprlang.

2026-05-27T14:14:51Z

Started updating the wiki for Hyprland 0.55 and the replacement of hyprlang.

← Older revision		Revision as of 14:14, 27 May 2026
Line 134:		Line 134:

	=== 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>start-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]]		* [[GDM]]
Line 141:		Line 141:

	== Configuration ==		== Configuration ==
	On first run, Hyprland will create a configuration file with autogenerated defauts in <code>$XDG_CONFIG_HOME/hypr/hyprland.~~conf~~</code> if it does not exist. An example configuration can be found in the [https://github.com/hyprwm/Hyprland/blob/v0.54.3-b/example/hyprland.~~conf~~ project's git repository].		On first run, Hyprland will create a configuration file with autogenerated defauts in <code>$XDG_CONFIG_HOME/hypr/hyprland.lua</code> if it does not exist. An example configuration can be found in the [https://github.com/hyprwm/Hyprland/blob/v0.55.2-b/example/hyprland.lua project's git repository].

	=== Using [[Home Manager]] ===		=== Using [[Home Manager]] ===
Line 180:		Line 180:
	};		};
	};\|name=/etc/nixos/home.nix\|lang=nix}}		};\|name=/etc/nixos/home.nix\|lang=nix}}

			=== Using symlinks and Home Manager ===
			{{File\|3=xdg.configFile."hypr" = {
			source = config.lib.file.mkOutOfStoreSymlink "${dotfiles}/hypr";
			force = true;
			recursive = true;
			};\|name=home.nix\|lang=nix}}
			This will create a symlink between ~/.config/hypr and your nixos config location.

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

DHCP: /* Nix on Non-NixOS Systems */ use syntaxHighlight lang=console and the "$" prefix for shell commands

2026-05-19T15:36:57Z

Nix on Non-NixOS Systems: use syntaxHighlight lang=console and the "$" prefix for shell commands

← Older revision		Revision as of 15:36, 19 May 2026
Line 33:		Line 33:
	Firstly, enable [https://wiki.nixos.org/wiki/Flakes#Other_Distros,_without_Home-Manager flakes] in your Nix installation. Then install Hyprland through <code>nix profile</code>:		Firstly, enable [https://wiki.nixos.org/wiki/Flakes#Other_Distros,_without_Home-Manager flakes] in your Nix installation. Then install Hyprland through <code>nix profile</code>:

	<syntaxHighlight lang=~~text~~>		<syntaxHighlight lang=console>
	nix profile install nixpkgs#hyprland		$ nix profile install nixpkgs#hyprland
	</syntaxHighlight>		</syntaxHighlight>

	In order for Hyprland to find graphics drivers on a non-NixOS system, you will need to install [[nixGL]]:		In order for Hyprland to find graphics drivers on a non-NixOS system, you will need to install [[nixGL]]:

	<syntaxHighlight lang=~~text~~>		<syntaxHighlight lang=console>
	nix profile install github:nix-community/nixGL --impure		$ nix profile install github:nix-community/nixGL --impure
	</syntaxHighlight>		</syntaxHighlight>

	Now you can run Hyprland by invoking it with NixGL:		Now you can run Hyprland by invoking it with NixGL:

	<syntaxHighlight lang=~~text~~>		<syntaxHighlight lang=console>
	nixGL Hyprland		$ nixGL Hyprland
	</syntaxHighlight>		</syntaxHighlight>

DHCP: Added {{outdated}} banner: configuration is done in Lua starting from v0.55. Note: banner adapted from ArchWiki <3

2026-05-13T19:51:45Z

Added {{outdated}} banner: configuration is done in Lua starting from v0.55. Note: banner adapted from ArchWiki <3

← Older revision		Revision as of 19:51, 13 May 2026
Line 1:		Line 1:
	<translate>		<translate>
			{{outdated\|date=may 2026\|reason=[https://hypr.land/news/update55/ v0.55] introduced and recommends [[Lua]] for configuration. The [https://wiki.hypr.land upstream wiki] has already migrated and support for {{ic\|hyprland.conf}} will be removed in a future release. Home manager support is [https://github.com/nix-community/home-manager/pull/9307 in progress.]\|Talk:Hyprland#Lua}}

	[https://hypr.land/ 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.hypr.land/ wiki].		[https://hypr.land/ 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.hypr.land/ wiki].

DHCP: update links, other minor fixes

2026-05-13T19:41:37Z

update links, other minor fixes

← Older revision		Revision as of 19:41, 13 May 2026
Line 1:		Line 1:
	<translate>		<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://hypr.land/ 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.hypr.land/ wiki].

	Some of the most notable features of Hyprland are:		Some of the most notable features of Hyprland are:
Line 38:		Line 38:

	<syntaxHighlight lang=text>		<syntaxHighlight lang=text>
	nix profile install github:~~guibou~~/nixGL --impure		nix profile install github:nix-community/nixGL --impure
	</syntaxHighlight>		</syntaxHighlight>

Line 56:		Line 56:
	* '''hyprpolkitagent''': Polkit authentication agent written in QT/QML.		* '''hyprpolkitagent''': Polkit authentication agent written in QT/QML.

	All official Hypr* programs are listed in the project's [https://wiki.~~hyprland~~.~~org~~/Hypr-Ecosystem/ wiki page] along with documentation.		All official Hypr* programs are listed in the project's [https://wiki.hypr.land/Hypr-Ecosystem/ wiki page] along with documentation.

	=== Hyprland Flake ===		=== Hyprland Flake ===
	{{Warning\|Installing Hyprland through a Nix flake will require the system to recompile Hyprland and all of its dependencies each time it updates. To avoid this, setup [[~~Hyprland~~#Cachix\|Hyprland's Cachix settings]] before adding Hyprland as a flake input.}}		{{Warning\|Installing Hyprland through a Nix flake will require the system to recompile Hyprland and all of its dependencies each time it updates. To avoid this, setup [[#Cachix\|Hyprland's Cachix settings]] before adding Hyprland as a flake input.}}

	If you wish to run a development version of Hyprland, you can easily do so by adding its flake to your flake inputs as demonstrated below:		If you wish to run a development version of Hyprland, you can easily do so by adding its flake to your flake inputs as demonstrated below:
Line 136:		Line 136:
	* [[GDM]]		* [[GDM]]
	* [[Greetd]] (especially with ReGreet)		* [[Greetd]] (especially with ReGreet)
	* [[Ly]] (not recommended but works)		* [https://codeberg.org/fairyglade/ly Ly] (not recommended, but works)

	== Configuration ==		== Configuration ==
	On first run, Hyprland will create a configuration file with autogenerated defauts in <code>$XDG_CONFIG_HOME/hypr/hyprland.conf</code> if it does not exist. An example configuration can be found in the [https://github.com/hyprwm/Hyprland/blob/~~main~~/example/hyprland.conf project's git repository].		On first run, Hyprland will create a configuration file with autogenerated defauts in <code>$XDG_CONFIG_HOME/hypr/hyprland.conf</code> if it does not exist. An example configuration can be found in the [https://github.com/hyprwm/Hyprland/blob/v0.54.3-b/example/hyprland.conf project's git repository].

	=== Using [[Home Manager]] ===		=== Using [[Home Manager]] ===
	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.		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.

	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.		Find additional options under [https://nix-community.github.io/home-manager/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.

	{{File\|3=wayland.windowManager.hyprland = {		{{File\|3=wayland.windowManager.hyprland = {
Line 282:		Line 282:

	== See also ==		== See also ==
	* [https://~~hyprland~~.~~org~~/ Hyprland Website]		* [https://hypr.land/ Hyprland Website]
	* [https://wiki.~~hyprland~~.~~org~~/ The official documentation]		* [https://wiki.hypr.land/ The official documentation]
	* [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]

Martin Hamel: /* Display Manager Support */ Gdm does not crash

2026-05-07T20:58:12Z

Display Manager Support: Gdm does not crash

← Older revision		Revision as of 20:58, 7 May 2026
Line 134:		Line 134:
	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]]
	* [[Greetd]] (especially with ReGreet)		* [[Greetd]] (especially with ReGreet)
	* [[Ly]] (not recommended but works)		* [[Ly]] (not recommended but works)

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>