FreeBSD Manual Pages
xdg-desktop-portal-wlr(5) File Formats Manual xdg-desktop-portal-wlr(5) NAME xdg-desktop-portal-wlr - an xdg-desktop-portal backend for wlroots DESCRIPTION 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: [screencast] output_name=HDMI-A-1 max_fps=30 exec_before=disable_notifications.sh exec_after=enable_notifications.sh chooser_type=simple chooser_cmd=slurp -f %o -or SCREENCAST OPTIONS 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 interaction. o simple, dmenu: xdpw will launch the chooser given by chooser_cmd. For more details see OUTPUT CHOOSER. 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 user. 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 stdin. o dmenu: the chooser receives a newline separated list (dmenu style) of outputs on stdin. SEE ALSO pipewire(1) 2022-04-03 xdg-desktop-portal-wlr(5)
NAME | DESCRIPTION | SCREENCAST OPTIONS | SEE ALSO
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=xdg-desktop-portal-wlr&sektion=5&manpath=FreeBSD+13.1-RELEASE+and+Ports>