From Fedora Project Wiki

< Changes

Revision as of 08:30, 26 June 2019 by Jgrulich (talk | contribs)

Qt Wayland By Default On Gnome


Make Qt applications to run natively on Gnome Wayland session, using the Qt Wayland platform plugin instead of the XCB plugin which is used for X11/XWayland. Other desktop environments already run natively on Wayland sessions, only Gnome is excluded by Qt.


  • Name: Jan Grulich
  • Email: <>
  • Release notes owner:
  • Product: Spins / Workstation
  • Responsible WG: Desktop

Current status

  • Targeted release: Fedora 31
  • Last updated: 2019-06-26
  • Tracker bug:
  • Release notes tracker:

Detailed Description

Qt Wayland plugin has been available for a long time, but it hasn't been in condition where it could be enabled by default. With Qt 5.12 the state of the Wayland plugin is much better and it's becoming more and more reliable. It now supports all the needed protocols and has been enabled by default for non-Gnome Wayland sessions. With Qt Wayland on Gnome Wayland session we need to support CSD, it's actually the only way how decorations are going to work in Qt apps right now. Qt Wayland implements basic decorations, which really doesn't match Gnome Adwaita theme, therefore there are new CSD being implemented as part of QGnomePlatform.

To make Qt applications run natively on Wayland we need to modify Qt 5, specifically qt5-qtbase module, where we allow the Wayland plugin to be used also for Gnome sessions. The new decorations from QGnomePlatform will be used automatically once they are fully implemented and updated in Fedora.

Benefit to Fedora

Qt applications running with the wayland plugin run generally faster and smoother on Wayland enabled sessions like Gnome Wayland and better support HiDPI displays (respects desktop scale) .


  • Proposal owners:
  1. Modify Qt 5 (qt5-qtbase) to not exclude Gnome when deciding whether to use the wayland platform plugin
  2. Update QGnomePlatform with upcoming upstream release including window decorations
  • Other developers:
  1. Test and watch for regressions.
  • Policies and guidelines: N/A (not a System Wide Change)
  • Trademark approval: N/A (not needed for this Change)

Upgrade/compatibility impact

N/A (not a System Wide Change)

How To Test

N/A (not a System Wide Change)

Run any Qt application on Gnome Wayland session and check any issues you may see.

User Experience

  • Smoother font rendering compared to Qt applications using XCB plugin
  • Honor display scale, better user experience on HiDPI and semi-HiDPI desktops.


N/A (not a System Wide Change)

Contingency Plan

  • Contingency mechanism: Switch back default X11 backend.
  • Contingency deadline: Beta Freeze
  • Blocks release? No
  • Blocks product? product No


N/A (not a System Wide Change)

Release Notes