UWSM - Revision history

Phobos at 04:03, 13 December 2025

2025-12-13T04:03:29Z

← Older revision		Revision as of 04:03, 13 December 2025
Line 21:		Line 21:
	=== Hyprland ===		=== Hyprland ===

			===== Standalone Hyprland with UWSM =====
			Hyprland has a built in option for UWSM that will automatically handle setup. Automatically starts appropriate targets such as <code>graphical-session.target</code>, and <code>wayland-session@Hyprland.target</code>. This option is recommended for if you are using Hyprland standalone, and do not need to configure alternative entries for UWSM. Usage of both options in conjunction may run into issues.
	Hyprland has a built in option for UWSM that will automatically handle setup. Automatically starts appropriate targets such as <code>graphical-session.target</code>, and <code>wayland-session@Hyprland.target</code>.

	{{Note\|Some changes may need to be made to Hyprland configs depending on your setup, see the [https://wiki.hypr.land/Useful-Utilities/Systemd-start/#uwsm\|Hyprland's UWSM wiki Page].}}{{File\|3=programs.hyprland = {		{{Note\|Some changes may need to be made to Hyprland configs depending on your setup, see the [https://wiki.hypr.land/Useful-Utilities/Systemd-start/#uwsm\|Hyprland's UWSM wiki Page].}}{{File\|3=programs.hyprland = {
Line 29:		Line 28:
	withUWSM = true;		withUWSM = true;
	};\|name=/etc/nixos/configuration.nix\|lang=nix}}		};\|name=/etc/nixos/configuration.nix\|lang=nix}}

			===== If using the Hyprland Home Manager Module =====
			If you use the Home Manager module, make sure to disable the systemd integration as it conflicts with UWSM.<ref>https://wiki.hypr.land/Useful-Utilities/Systemd-start/#uwsm</ref>

			{{File\|3=wayland.windowManager.hyprland.systemd.enable = false;\|name=/etc/nixos/home.nix\|lang=nix}}

Phobos at 03:56, 13 December 2025

2025-12-13T03:56:07Z

← Older revision		Revision as of 03:56, 13 December 2025
Line 22:		Line 22:


	~~Additional information~~ may be ~~found~~ on the [[Hyprland\|~~Hyprland page]]~~.
			Hyprland has a built in option for UWSM that will automatically handle setup. Automatically starts appropriate targets such as <code>graphical-session.target</code>, and <code>wayland-session@Hyprland.target</code>.

			{{Note\|Some changes may need to be made to Hyprland configs depending on your setup, see the [https://wiki.hypr.land/Useful-Utilities/Systemd-start/#uwsm\|Hyprland's UWSM wiki Page].}}{{File\|3=programs.hyprland = {
			enable = true;
			withUWSM = true;
			};\|name=/etc/nixos/configuration.nix\|lang=nix}}

Phobos: Initial Page creation for UWSM

2025-12-13T03:48:06Z

Initial Page creation for UWSM

New page

[https://github.com/Vladimir-csp/uwsm UWSM (Universal Wayland Session Manager)], wraps standalone Wayland compositors with a set of Systemd units on the fly. This essentially binds the Wayland compositor into <code>graphical-session-pre.target</code>, <code>graphical-session.target</code>, <code>xdg-desktop-autostart.target</code>.

This is useful for Wayland compositors like Hyprland, Sway, Wayfire, etc. that do not start these targets and services on their own.

Additional information may be found on [https://github.com/Vladimir-csp/uwsm the UWSM Github], or the [https://wiki.archlinux.org/title/Universal_Wayland_Session_Manager Arch Wiki page].

== Installation ==
Options may be found under [https://search.nixos.org/options?query=programs.uwsm programs.uwsm] in Nix options. An example using [[Sway]] with UWSM:
{{File|3=programs.uwsm = {
enable = true;
# You must configure the waylandCompositors suboptions so that UWSM knows which compositors to manage.
waylandCompositors = {
sway = {
prettyName = "Sway";
comment = "Sway compositor managed by UWSM";
binPath = "/run/current-system/sw/bin/sway";
};
};
};|name=/etc/nixos/configuration.nix|lang=nix}}{{Note|1=This by default uses <code>dbus-broker</code> as the dbus implementation for better compatibility. If you dislike this behavior you may set <code>services.dbus.implementation = lib.mkForce "dbus"</code> in your configuration.}}

=== Hyprland ===

Additional information may be found on the [[Hyprland|Hyprland page]].