Skip to content
The UKUI platform theme for qt5 QPA.
C++ QMake C Prolog
Branch: master
Clone or download

Latest commit

Yue-Lan implement enableBlur protocol:
use dynamic property enableBlur in qApp instance indicate
wether blur effect is enabled.

BlurHelper: handle enabled-global-blur settings correctly.

Qt5UKUIStyle: when blur effect is not enable, not draw a
transparent menu.
Latest commit ae67729 Apr 4, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.


The UKUI platform theme for qt5 QPA.


See doxygen/


In the early development of the UKUI 3.0, we used qt5-gtk2-platformtheme to ensure the unity of the UKUI desktop style. However, it has many limitations for our new desgin.

This project is intend to provide a common resolution of desktop application development with qt5 in UKUI3.0. We hope provide a platform theme to unify and beautify all qt applications according to the design of UKUI3.0, not only our own applications. We are also committed to building our applications that can adapt to different styles. This project is first step to archive those objectives.

qt5-ukui-platformtheme's route brings us closer to the upstream communities. It is not a division, but a desire for fusion and individuality in a compatible way.

Build and Test

Build Depends (reference debian/contorl)

  • pkg-config
  • qt5-default
  • qtbase5-private-dev
  • libkf5windowsystem-dev
  • libgsettings-qt-dev
  • libglib2.0-dev


To test the project, you should first install it into system and make sure that the current qpa platform is ukui. You can export the QT_QPA_PLATFORMTHEME in terminal.


One more important job,

sudo glib-compile-schemas /usr/share/glib-2.0/schemas

That will let the gsettings used by qt5-ukui-platformtheme worked.

Then you can run the test in project, or run any qt5 program for testing with ukui platformtheme.


  • menu blur
  • custom palette
  • style switch/management
  • Change style's details through configuration file
  • animations
You can’t perform that action at this time.