Hyprland: Difference between revisions

DHCP (talk | contribs)
m Nix on Non-NixOS Systems: use syntaxHighlight lang=console and the "$" prefix for shell commands
DHCP (talk | contribs)
m Add link to the corresponding talk page in the {{outdated}} template
 
(2 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 support is [https://github.com/nix-community/home-manager/pull/9307 in progress.]|Talk:Hyprland#Lua}}
{{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 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 ==