Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
xdg-desktop-portal-wlr(5)     File Formats Manual    xdg-desktop-portal-wlr(5)

       xdg-desktop-portal-wlr -	an xdg-desktop-portal backend for wlroots

       xdg-desktop-portal-wlr (or xdpw for short) allows applications to re-
       quest screenshots and screencasts via xdg-desktop-portal	in wlroots-
       based Wayland compositors.

       xdpw will try to	load the configuration file from these locations:

       o   $XDG_CONFIG_HOME/xdg-desktop-portal-wlr/$XDG_CURRENT_DESKTOP
       o   $XDG_CONFIG_HOME/xdg-desktop-portal-wlr/config
       o   /usr/local/etc/xdg/xdg-desktop-portal-wlr/$XDG_CURRENT_DESKTOP
       o   /usr/local/etc/xdg/xdg-desktop-portal-wlr/config

       $XDG_CONFIG_HOME	defaults to ~/.config. $XDG_CURRENT_DESKTOP can	be a
       colon seperated list. Each element of that list will be tried.

       The configuration files use the INI file	format.	Example:

	   chooser_cmd=slurp -f	%o -or

       These options need to be	placed under the [screencast] section.

       output_name = name
	   Select which	output will be screencast.

	   This	option is used with chooser_type = none. The list of available
	   outputs can be obtained via wayland-info(1) (under the zxdg_out-
	   put_manager_v1 section).

       max_fps = limit
	   Limit the number of frames per second to the	provided rate.

	   This	is useful to reduce CPU	usage when capturing frames at the
	   output's refresh rate is unnecessary.

       exec_before = command
	   Execute command before starting a screencast. The command will be
	   executed within sh.

       exec_after = command
	   Execute command after ending	all screencasts. The command will be
	   executed within sh.

       chooser_cmd = command
	   Run this command to select an output.

	   For more details see	OUTPUT CHOOSER.

       chooser_type = type
	   Specifies the input send to the chooser.

	   The supported types are:
	   o   default:	xdpw will try to use the first chooser found in	the
	       list of hardcoded choosers (slurp, wofi,	bemenu)	and will fall-
	       back to an arbitrary output if none of those were found.
	   o   none: xdpw will allow screencast	either on the output given by
	       output_name, or if empty	an arbitrary output without further
	   o   simple, dmenu: xdpw will	launch the chooser given by
	       chooser_cmd. For	more details see OUTPUT	CHOOSER.

       The chooser can be any program or script	with the following behaviour:
       o   It returns any error	code except 127. The error code	127 is inter-
	   nally used to signal	that no	command	could be found and all output
	   from	it will	be ignored.
       o   It returns the name of a valid output on stdout as given by way-
	   land-info(1). Everything else will be handled as declined by	the
       o   To signal that the user has declined	screencast, the	chooser	should
	   exit	without	anything on stdout.

       Supported types of choosers via the chooser_type	option:
       o   simple: the chooser is just called without anything further on
       o   dmenu: the chooser receives a newline separated list	(dmenu style)
	   of outputs on stdin.


				  2022-04-03	     xdg-desktop-portal-wlr(5)


Want to link to this manual page? Use this URL:

home | help