[Workaround] MPV has No title-bar & window border in Ubuntu 22.04

Last updated: August 21, 2022 — 4 Comments

In Ubuntu 22.04, you’ll find that the MPV media player does NOT have window border and title-bar out-of-the-box.

That’s quite annoying! You can no longer drag resizing the app window. And, title bar buttons (minimize, maximize, and close) only appear when you hover over the window during video playback.

MPV no window border and title bar


It’s NOT feature but a bug! Someone has reported the issue almost 9 years ago. Though, it’s still not been fixed due to GNOME Wayland protocol.

You know, MPV is a command line media player. It does not use the GUI toolkit for window borders, but the server-side protocol. However, GNOME developers do deliberately do not support the xdg-decoration protocol for server-side decorations in Wayland (via this FAQ).

Ubuntu 22.04 finally switched Wayland as the default session. So, the problem occurs.

Workaround 1: Switch back Xorg Session

Besides MPV, still many applications have compatibility issues with GNOME Wayland. Even the Night Light feature does not work in Ubuntu 22.04 with this session.

As a workaround, user may switch back to the classic Xorg session. To do so, simply log out, click your username in login screen, then select “Ubuntu on Xorg” via the bottom right gear button menu, and finally type password to log in.

To verify your current session either run echo $XDG_SESSION_TYPE command in terminal or check in “Settings -> About -> Windowing system”.

Workaround 2: Run MPV via X11 backend

For those prefer GNOME Wayland session, it’s possible to run MPV media player via X11 backend without switch session.

1.) To start video playback from command line, use command:

mpv --gpu-context=x11egl --hwdec=vaapi-copy PATH/TO/VIDEO_FILE

Here --gpu-context=x11egl tells to use x11 backend for video playback. And, --hwdec=vaapi-copy is required to enable GPU hardware acceleration in this case.

Thanks to S. Likhitrattanapisal, you may try --hwdec=vaapi flag to enable hwacc. Though it may not work, it depends on your hardware.

2.) To enable this for global use, you may add the flags into MPV configuration file.

Press Ctrl+Alt+T on keyboard to open terminal. When terminal opens, make a copy of configuration file first via command:

sudo cp /etc/mpv/mpv.conf /etc/mpv/mpv.conf.bak

Then, edit the file via command:

sudo xdg-open /etc/mpv/mpv.conf

When file opens, change the content into:


After saving the changes, start playing your movie via MPV. The window border as well as title-bar should be back!

Workaround 3: Use GUI front-end

There are a few media players that use MPV as backend. As far as I know, there are SMPlayer and Celluloid (formerly GNOME MPV), both of which are available to install via Ubuntu Software.


I'm a freelance blogger who started using Ubuntu in 2007 and wishes to share my experiences and some useful tips with Ubuntu beginners and lovers. Please comment to let me know if the tutorial is outdated! And, notify me if you find any typo/grammar/language mistakes. English is not my native language. Contact me via [email protected] Buy me a coffee: https://ko-fi.com/ubuntuhandbook1

4 responses to [Workaround] MPV has No title-bar & window border in Ubuntu 22.04

  1. S. Likhitrattanapisal July 19, 2022 at 1:11 pm

    Thanks for nice tips.

    In my case, video playback with ‘hwdec=vaapi-copy’ is frustratingly lagging.
    So I leave ‘hwdec=vaapi’ in my mpv.conf. It looks like this;


  2. happy_mpv_user_on_ubuntu July 31, 2022 at 12:24 pm

    Thank you for the tutorial

  3. thanks, appreciated!

  4. Thanks Ji m. I recently did a fresh installation of 22.04, after using 18.04 many years. I was now missing SMP player. I chose to work without switch session, and ithen installed smp player . The result is perfect.
    I am 80 years, not native English , but yourworkarounds are always very clear and good understand.

Leave a Reply

Text formatting is available via select HTML.

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>