/QAdwaitaPlatform

QPlatformTheme for a better Qt application inclusion in GNOME

Primary LanguageC++GNU Lesser General Public License v2.1LGPL-2.1

QAdwaitaPlatform

AUR version GitHub issues GitHub Repo stars GitHub

The project was abandoned and is now unmaintained due to irrelevance. It is recommended to use an alternative in the form of QAdwaitaDecorations.

QAdwaitaPlatform is QGnomePlatform fork that implements modern LibAdwaita window decoration look to Qt applications.

Result

🌑 Dark Scheme

☀️ Light Scheme

How to compile

This library uses private Qt headers and will likely not be forward nor backward compatible. This library will have to be recompiled with every Qt update.

Step-by-step guide

  1. Create 2 directories for Qt 5 and Qt 6 builds

    mkdir build-qt6 build-qt5

  2. Change the directory to one of the previously created ones, depending on for which version of Qt you are building. (e.g. cd build-qt6)

  3. Run cmake command

    cmake -DUSE_QT6=false .. - for Qt 5 build

    cmake -DUSE_QT6=true .. - for Qt 6 build

  4. Build & install QAdwaitaPlatform

    make && sudo make install

Build dependencies

Packages names are depends on what distribution are you using. There is list for ArchLinux below.

  • adwaita-qt6, adwaita-qt5
  • qt6-wayland, qt5-wayland, qt5-quickcontrols2
  • cmake, git, gtk3

Usage

This library is used automatically in Gtk based desktops such as Gnome, Cinnamon or Xfce.

This platform theme can also be used by setting the QT_QPA_PLATFORMTHEME environment variable to "gnome". For example, put the following command in .bashrc:

export QT_QPA_PLATFORMTHEME='gnome'

License

Most code is under LGPL 2.1 with the "or any later version" clause. New code should be contributed under this license.

This project also incorporates some code from the Qt Project. Because of that the so-called combined work is licensed under LGPL 3.0-only, GPL 2.0, GPL 3.0, or any later GPL version approved by the KDE Free Qt Foundation.