Wayland: support the xx-pip-v1 protocol for true picture-in-picture windows

Open
#18,751 5 comments 1 reaction 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
45/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
c, linux
Domain
desktop

Research direction

Start by reading mpv's Wayland window-management code and the xx-pip-v1 protocol documentation, then check how existing Wayland window states are handled. The issue requests native picture-in-picture support using this experimental protocol; done means a Wayland PiP window can be requested through the protocol. The issue names no source files or tests, so locating the relevant entry point will require familiarity with the Wayland backend.

Written by the indexing model from the issue text.

Description

meta:feature-request
Expected behavior of the wanted feature

Windows and X11 users can get a true PiP window with --ontop, but this doesn’t work on Wayland. Plasma 6.8 has now dropped its X11 session entirely, so KDE users on Wayland have no native way to get this. I’ll admit I don’t know much about how the protocol works, so please correct me if I’ve got anything wrong. From what I can tell, Firefox and KDE’s KClock already implement the experimental xx-pip-v1 protocol, and KWin supports it. KWin’s support is scheduled to be enabled by default in Plasma 6.9 (due February 2027). I understand the protocol is still experimental, but I’d like to track support for it here, and I’m happy to test patches on KDE Plasma.

Alternative behavior of the wanted feature

No response

Log File

No response

Sample Files

No response

Dominant language
C
Stars
38.2k
Forks
3.7k
Avg merge
1d 13h
Merged PRs (30d)
76

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from mpv-player/mpv

All issues in mpv-player/mpv

Similar issues

More C issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.