osfeed.dev
Projects/hyprwm / xdg-desktop-portal-hyprland

xdg-desktop-portal-hyprland

The screen sharing and desktop portal backend for Hyprland

by@hyprwm·Runs on Linux
Get it on GitHub
Unclaimed

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.

Are you @hyprwm?Claim it, and your coding agent keeps it current with each release

Share a monitor, a window or a region from Hyprland in browsers, OBS and chat apps, take portal screenshots, and let apps register global shortcuts.

What you can do with xdg-desktop-portal-hyprland

Let apps capture keyboard and mouse input through the InputCapture portal, as tools that share input across computers do.

Since v1.4.0
Good to know

Only apps that use the InputCapture portal benefit.

Share
Wrong?

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.

Share
Wrong?

Before you upgrade xdg-desktop-portal-hyprland

Newest first
v1.5.0

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
Read the evidence
Share
Wrong?
Show 2 older
xdg-desktop-portal-hyprland release history 10
v1.5.0

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

Seeded by @iluxav with Codex

Read the evidence
v1.4.1

Show the cursor again when you share your screen from a browser or Discord.

Details

screencopy:cursor_mode sets the cursor mode for clients that do not ask for one (2 embeds the cursor); a busy loop that used CPU is fixed.

v1.4.1.

Improved: Share a whole monitor, a single window or a region…

Seeded by @iluxav with Claude Code

Read the evidence
v1.4.0

Let apps that share your keyboard and mouse with other computers capture input on Hyprland.

Details

Implements the InputCapture portal; the screencast backend moves to version 6 (version property, mapping_id, pipewire-serial).

v1.4.0.

Added / inferred: Let apps capture keyboard and mouse input through t…

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.12

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…

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.10

See the right shortcuts when an app lists its global shortcuts.

Details

ListShortcuts returned its arguments in the wrong order; window titles and classes are set properly for sharing.

v1.3.10.

Now works / inferred: Let apps register global shortcuts that you bind in…

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.9

Use your own program to choose what to share instead of the built-in picker.

Details

screencopy:custom_picker_binary points to a replacement for hyprland-share-picker.

v1.3.9.

Improved: Share a whole monitor, a single window or a region…

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.8

Share windows when dynamic activation is enabled.

Details

Window sharing works again with general:toplevel_dynamic_bind; the portal now builds against sdbus-cpp 2. Groups v1.3.7 and v1.3.8.

v1.3.8; building needs sdbus-cpp 2.0.0.

Now works: Share a whole monitor, a single window or a region…Action required

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.6

Restore a shared window, not only a monitor, when an app reconnects.

Details

Window handles are restored from the restore token.

v1.3.6.

Now works: Share a whole monitor, a single window or a region…

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.5

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

Seeded by @iluxav with Claude Code

Read the evidence
v1.3.3
Starting point

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…

Seeded by @iluxav with Claude Code

Read the evidence

Share

LinkedIn takes the link and its card only; write your text there.

X LinkedIn Reddit Hacker News Bluesky