Displaylink - Revision history

Sandro: /* evdi module */

2026-01-18T09:59:18Z

evdi module

← Older revision		Revision as of 09:59, 18 January 2026
Line 39:		Line 39:
	};		};
	};		};
	<syntaxhighlight ~~lang="nix"~~>		</syntaxhighlight>

	====='''Gnome Wayland'''=====		====='''Gnome Wayland'''=====
Line 45:		Line 45:
	Install displayLink package		Install displayLink package

	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	displaylink		displaylink
	];		];
	</~~nowiki~~>}}		</syntaxhighlight>

	Define videoDrivers		Define videoDrivers
Line 57:		Line 57:

	Add dlm service		Add dlm service
	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	systemd.services.dlm.wantedBy = [ "multi-user.target" ];		systemd.services.dlm.wantedBy = [ "multi-user.target" ];
	</~~nowiki~~>}}		</syntaxhighlight>
	====='''KDE Plasma'''=====		====='''KDE Plasma'''=====

Line 66:		Line 66:
	Esnure you properly enabled wayland session		Esnure you properly enabled wayland session

	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	environment.variables = {		environment.variables = {
	KWIN_DRM_PREFER_COLOR_DEPTH = "24";		KWIN_DRM_PREFER_COLOR_DEPTH = "24";
Line 84:		Line 84:

	};		};
	</~~nowiki~~>}}		</syntaxhighlight>

	Install displayLink package		Install displayLink package

	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	environment.systemPackages = with pkgs; [		environment.systemPackages = with pkgs; [
	displaylink		displaylink
	];		];
	</~~nowiki~~>}}		</syntaxhighlight>

	Instead of dlm setup display-link server as follows:		Instead of dlm setup display-link server as follows:

	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	~~# --- THIS IS THE CRUCIAL PART FOR ENABLING THE SERVICE ---~~
	systemd.services.displaylink-server = {		systemd.services.displaylink-server = {
	enable = true;		enable = true;
	~~# Ensure it starts after udev has done its work~~
	requires = [ "systemd-udevd.service" ];		requires = [ "systemd-udevd.service" ];
	after = [ "systemd-udevd.service" ];		after = [ "systemd-udevd.service" ];
	wantedBy = [ "multi-user.target" ]; ~~# Start at boot~~		wantedBy = [ "multi-user.target" ];
	# * THIS IS THE CRITICAL 'serviceConfig' BLOCK *
	serviceConfig = {		serviceConfig = {
	Type = "simple"; ~~# Or "forking" if it forks (simple is common for daemons)~~		Type = "simple";
	~~# The ExecStart path points to the DisplayLinkManager binary provided by the package~~
	ExecStart = "${pkgs.displaylink}/bin/DisplayLinkManager";		ExecStart = "${pkgs.displaylink}/bin/DisplayLinkManager";
	~~# User and Group to run the service as (root is common for this type of daemon)~~
	User = "root";		User = "root";
	Group = "root";		Group = "root";
	~~# Environment variables that the service itself might need~~
	~~# Environment = [ "DISPLAY=:0" ]; # Might be needed in some cases, but generally not for this~~
	Restart = "on-failure";		Restart = "on-failure";
	RestartSec = 5; # Wait 5 seconds before restarting		RestartSec = 5; # Wait 5 seconds before restarting
	};		};
	};		};
	</~~nowiki~~>}}		</syntaxhighlight>

	==Sway==		==Sway==

Sandro: /* evdi module */

2026-01-18T09:57:37Z

evdi module

← Older revision		Revision as of 09:57, 18 January 2026
Line 29:		Line 29:

	You probably will need the `evdi` module		You probably will need the `evdi` module
	~~{{bc\|~~<~~nowiki~~>		<syntaxhighlight lang="nix">
	boot = {		boot = {
	extraModulePackages = [ config.boot.kernelPackages.evdi ];		extraModulePackages = [ config.boot.kernelPackages.evdi ];
Line 39:		Line 39:
	};		};
	};		};
	<~~/nowiki~~>}}		<syntaxhighlight lang="nix">

	====='''Gnome Wayland'''=====		====='''Gnome Wayland'''=====

Sandro: /* DisplayLink monitors */

2026-01-18T09:57:24Z

DisplayLink monitors

← Older revision		Revision as of 09:57, 18 January 2026
Line 10:		Line 10:
	displaylink		displaylink
	];		];
	</syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="~~nixos~~">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.		</syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="nix">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.

	====<big>Xserver</big>====		====<big>Xserver</big>====
Line 119:		Line 119:
	};		};
	</nowiki>}}		</nowiki>}}


	==Sway==		==Sway==

LordXerus: Mention that pre-sleep.service has the potential to block suspend

2026-01-16T23:22:03Z

Mention that pre-sleep.service has the potential to block suspend

← Older revision		Revision as of 23:22, 16 January 2026
Line 155:		Line 155:

	[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]		[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]

			== Troubleshooting ==

			=== Suspend blocked by <code>pre-sleep.service</code> ===
			As of NixOS 25.05, installing <code>pkgs.displaylink</code> inserts some directives into the script referenced by <code>pre-sleep.service</code>. If suspending does not work and causes the reboot and poweroff buttons to stop working, it may be a symptom of [[Power Management#Suspend blocked by pre-sleep.service\|suspend being blocked by pre-sleep.service]].

			The script in question:<syntaxhighlight lang="bash" line="1">
			#!/nix/store/cfqbabpc7xwg8akbcchqbq3cai6qq2vs-bash-5.2p37/bin/bash
			set -e

			#flush any bytes in pipe
			while read -n 1 -t 1 SUSPEND_RESULT < /tmp/PmMessagesPort_out; do : ; done;

			#suspend DisplayLinkManager
			echo "S" > /tmp/PmMessagesPort_in

			#wait until suspend of DisplayLinkManager finish
			if [ -f /tmp/PmMessagesPort_out ]; then
			#wait until suspend of DisplayLinkManager finish
			read -n 1 -t 10 SUSPEND_RESULT < /tmp/PmMessagesPort_out
			fi

			</syntaxhighlight>Because of a stray <code>/tmp/PmMessagesPort_out</code> caused by an unclean shutdown, the suspend action was blocked by this script trying to flush the port. A myriad of solutions can be used to unblock the script and restore suspend:

			* Start <code>dlm.service</code> so that DisplayLinkManager can clear the ports and unblock the script
			* Use <code>sudo DisplayLinkManager</code> to clear the ports and unblock the script

			Untested solutions:

			* Removing the file
			* Killing the script

	[[Category:Video]]		[[Category:Video]]

Papanito: add details for KDE and Gnome

2025-06-21T13:01:11Z

add details for KDE and Gnome

@@ Line 12: / Line 12: @@
 </syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="nixos">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.
-At last - at least on Gnome using wayland you also have to enable ` dml`  service<syntaxhighlight lang="nix">
+====<big>Xserver</big>====
-systemd.services.dlm.wantedBy = [ "multi-user.target" ];
+=====Connecting a second external monitor=====
 In order to add a second external monitor you can add the following to your configuration:
@@ Line 22: / Line 19: @@
      ${lib.getBin pkgs.xorg.xrandr}/bin/xrandr --setprovideroutputsource 2 0
 '';</syntaxhighlight>
 ==Sway==

Papanito: Add dlm service

2025-04-11T18:42:46Z

Add dlm service

← Older revision		Revision as of 18:42, 11 April 2025
Line 11:		Line 11:
	];		];
	</syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="nixos">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.		</syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="nixos">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.

			At last - at least on Gnome using wayland you also have to enable ` dml` service<syntaxhighlight lang="nix">
			systemd.services.dlm.wantedBy = [ "multi-user.target" ];
			</syntaxhighlight>

	====Connecting a second external monitor====		====Connecting a second external monitor====

Papanito: Some restructuring and rephrasing

2025-04-11T18:39:33Z

Some restructuring and rephrasing

← Older revision		Revision as of 18:39, 11 April 2025
Line 1:		Line 1:
	===DisplayLink monitors===		===DisplayLink monitors===
	In order to use DisplayLink monitors over USB, such as the ASUS MB16AC, the DisplayLink driver needs to be installed~~:<syntaxhighlight lang="nixos">~~		In order to use DisplayLink monitors over USB, such as the ASUS MB16AC, the DisplayLink driver needs to be installed.
	~~services.xserver.videoDrivers = [ "displaylink" "modesetting" ];~~
	~~</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors~~.

	Since these drivers depend on binary unfree blobs, you will need to first add it to your Nix store.		Since these drivers depend on binary unfree blobs, you will need to first add it to your Nix store.

	~~When you try to use~~ <code>~~pkgs.~~displaylink</code> ~~in your nixos system, you will~~ get the instructions ~~printed to the stderr,~~ follow ~~those to prefetch the driver~~.		Run <code>nix-shell -p displaylink --arg config '{ allowUnfree = true; }'</code> to get the '''instructions and follow them'''.

	~~Run~~ <code>nix~~-shell -p~~ displaylink ~~--arg config '{ allowUnfree~~ = ~~true~~; }'</code> ~~to get the instructions~~.		When you try to use <code>pkgs.displaylink</code> in your nixos system, you will get the same instructions printed to the stderr, follow those to prefetch the driver. Once the blob is in the Nix store you can add the package<syntaxhighlight lang="nix">
			environment.systemPackages = with pkgs; [
			displaylink
			];
			</syntaxhighlight>Then add the videoDrivers:<syntaxhighlight lang="nixos">services.xserver.videoDrivers = [ "displaylink" "modesetting" ];</syntaxhighlight>The module <code>nixos/modules/hardware/video/displaylink.nix</code> should also work for wlroots compositors.

	====Connecting a second external monitor====		====Connecting a second external monitor====
Line 48:		Line 50:

	Note as of [https://github.com/NixOS/nixpkgs/pull/351752 2024-10-30] nixos-unstable sway uses <code>wlroots_0_18</code>. The patch above applies correctly but you will need to invoke sway with the <code>--unsupported-gpu</code> flag.		Note as of [https://github.com/NixOS/nixpkgs/pull/351752 2024-10-30] nixos-unstable sway uses <code>wlroots_0_18</code>. The patch above applies correctly but you will need to invoke sway with the <code>--unsupported-gpu</code> flag.


	[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]		[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]

	[[Category:Video]]		[[Category:Video]]

AlexHamre: Date seemed wrong

2025-04-02T20:33:45Z

Date seemed wrong

← Older revision		Revision as of 20:33, 2 April 2025
Line 47:		Line 47:
	</syntaxhighlight>		</syntaxhighlight>

	Note as of [https://github.com/NixOS/nixpkgs/pull/351752 ~~2014~~-10-30] nixos-unstable sway uses <code>wlroots_0_18</code>. The patch above applies correctly but you will need to invoke sway with the <code>--unsupported-gpu</code> flag.		Note as of [https://github.com/NixOS/nixpkgs/pull/351752 2024-10-30] nixos-unstable sway uses <code>wlroots_0_18</code>. The patch above applies correctly but you will need to invoke sway with the <code>--unsupported-gpu</code> flag.

	[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]		[https://gitlab.freedesktop.org/wlroots/wlroots/-/issues/1823#note_2146862 Source]

	[[Category:Video]]		[[Category:Video]]

Phanirithvij: add command to get the instructions

2025-03-13T14:30:45Z

add command to get the instructions

← Older revision		Revision as of 14:30, 13 March 2025
Line 7:		Line 7:

	When you try to use <code>pkgs.displaylink</code> in your nixos system, you will get the instructions printed to the stderr, follow those to prefetch the driver.		When you try to use <code>pkgs.displaylink</code> in your nixos system, you will get the instructions printed to the stderr, follow those to prefetch the driver.

			Run <code>nix-shell -p displaylink --arg config '{ allowUnfree = true; }'</code> to get the instructions.

	====Connecting a second external monitor====		====Connecting a second external monitor====

Phanirithvij at 06:52, 13 March 2025

2025-03-13T06:52:07Z

← Older revision		Revision as of 06:52, 13 March 2025
Line 6:		Line 6:
	Since these drivers depend on binary unfree blobs, you will need to first add it to your Nix store.		Since these drivers depend on binary unfree blobs, you will need to first add it to your Nix store.

	When you try to use `pkgs.displaylink` in your nixos system, you will get the instructions printed to the stderr, follow those to prefetch the driver.		When you try to use <code>pkgs.displaylink</code> in your nixos system, you will get the instructions printed to the stderr, follow those to prefetch the driver.

	====Connecting a second external monitor====		====Connecting a second external monitor====