Official NixOS Wiki

Hyprland: Difference between revisions

← Older edit
DHCP (talk | contribs)
232 edits
VisualWikitext
DHCP (talk | contribs)
232 edits
update links, other minor fixes
DHCP (talk | contribs)
232 edits
m Add link to the corresponding talk page in the {{outdated}} template
 
(4 intermediate revisions by 2 users not shown)
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 supports lua config since the [https://nix-community.github.io/home-manager/release-notes/rl-2605.html#state-version-changes <code>26.05</code> release].|talk=Talk:Hyprland#Update to Hyprland 0.55}}
[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].  


Line 31: 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>


Line 132: 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 139: 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 178: 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 ==
Retrieved from "https://wiki.nixos.org/wiki/Hyprland"