wf‐stream‐chooser

Stream Chooser

wf-shell now ships with a window/output chooser which allows the user to select a stream to cast to any application requesting a stream.

portal-gum-test.webm

First use after update

After updating the service which calls this needs to be restarted. This is not required if you log out or restart after installing the update, only if you remain on the same session.

systemctl --user restart xdg-desktop-portal-wlr.service

Prerequisites

To use this effectively, the wlroots session requires these protocols:

• ext-image-copy-capture
• ext-foreign-toplevel-list

To use them in wayfire you need:

Copy-capture plugin installed

and to enable as such

plugins = ... foreign-toplevel copy-capture

As of last check (2025-05-17), wayfire will need to be restarted before these fully enable.

Also ensure you have an autostart option with

00_environment = dbus-update-activation-environment --systemd WAYLAND_DISPLAY DISPLAY XAUTHORITY WAYFIRE_SOCKET XDG_CURRENT_DESKTOP=wayfire

As user services require this information to function

Usage

At this point it should Just Work™. Any attempt by a wayland aware application to stream will launch wf-stream-chooser.

For easy testing try using Mozilla GUM.

Configuration

This application currently has no configuration options