From Fedora Project Wiki

< Changes

Revision as of 07:34, 26 June 2019 by Jgrulich (talk | contribs) (Update)

Qt Wayland By Default On Gnome


Qt applications are going to run natively on Gnome Wayland session and won't use XCB plugin by default. The XCB plugin can still be used when set using QT_QPA_PLATFORM variable or using app -platform xcb option. Other desktop environments already run Qt applications natively on Wayland. This change also includes new client-side window decorations to match Gnome Adwaita theme.


  • 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.

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