Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v1.5.0 (2026-10-28), so it may lag behind newer releases.
Share a selected workspace with apps that use the screen-sharing portal.
Since v1.5.0
Good to know
Requires compositor support for ext-workspace, ext-image-copy-capture and hyprland-workspace-image-capture-source; also needs PipeWire and xdg-desktop-portal.
Install `hyprtoolkit >= 0.6.0` and `wayland-protocols >= 1.39`. Provide `hyprland-protocols` with the workspace-capture XML (CMake checks >= 0.8.0), or update the bundled submodule. The picker no longer needs Qt.
Action requiredInferredAffects: People building from source
Cursor handling now follows the portal spec, so apps that do not ask for the cursor (browsers, Discord) share without it; v1.4.1 adds screencopy:cursor_mode to change the default.
Behavior changedInferredAffects: People sharing their screen from browsers or Discord
Share a selected Hyprland workspace through the desktop portal.
Details
The picker adds a workspace tab alongside monitors, windows and regions. Capture fixes address frozen streams and incomplete DMA-BUF frames; the built-in picker now uses hyprtoolkit.
Also: Screen sharing recovers from buffer starvation and format renegotiation; multi-plane GPU capture is fixed, and the sharing dialog changes.
v1.5.0 for Linux/Hyprland with PipeWire and xdg-desktop-portal; workspace sharing requires compositor workspace-capture protocol support.
Added / inferred: Share a selected workspace with apps that use the s…Now works: Share a whole monitor, a single window or a region…Behavior changed / inferredAction required / inferred
Restore a shared screen region with the same area you picked.
Details
Region shares keep their geometry in the restore token; screen sharing falls back from DMA-BUF to shared memory when needed, and screencopy:force_shm forces shared memory; the cursor follows the portal spec.
v1.3.12.
Improved: Share a whole monitor, a single window or a region…Behavior changed / inferred: Share a whole monitor, a single window or a region…
Let apps share your screen again after a restart without asking each time.
Details
screencopy:allow_token_by_default ticks the "allow restore token" box in the picker by default; restore data now survives app restarts; --version added. Groups v1.3.4 and v1.3.5.
v1.3.5; building needs hyprwayland-scanner 0.4.2 or newer and hyprutils.
Improved: Share a whole monitor, a single window or a region…Action required
Share your screen from Hyprland in browsers, OBS and chat apps.
Details
State as of v1.3.3: the portal implements ScreenCast (a monitor, a window or a region, picked with hyprland-share-picker), Screenshot and GlobalShortcuts; screencopy:max_fps caps the frame rate.
Build with CMake; needs PipeWire, sdbus-cpp, hyprlang and hyprland-protocols.
Added: Share a whole monitor, a single window or a region…Added: Let apps take screenshots through the desktop porta…Added / inferred: Let apps register global shortcuts that you bind in…