desktop-app / qt5ct

Mirror of the Qt5 Configuration Tool repository
BSD 2-Clause "Simplified" License
32 stars 7 forks source link

qt5ct - Qt5 Configuration Tool

This program allows users to configure Qt5 settings (theme, font, icons, etc.) under DE/WM without Qt integration.

Official home page: https://sourceforge.net/projects/qt5ct/

Requirements:

Installation:

qmake PREFIX= make make install (under root)

Add line 'export QT_QPA_PLATFORMTHEME=qt5ct' to ~/.profile and re-login. Alternatively, create the file /etc/X11/Xsession.d/100-qt5ct with the following line:

export QT_QPA_PLATFORMTHEME=qt5ct

Now restart X11 server to take the changes effect.

Extra build options (for advanced users only): qmake DISABLE_WIDGETS=1 - compiles platform plugin without QtWidgets (useful for QML applications only) qmake DISABLE_DBUS=1 - disable D-Bus support (global menu and D-Bus tray icon implementation) qmake PLUGINDIR= - changes the default installation path of the plugins (libqt5ct.so and libqt5ct-style.so)

Wayland:

If you are running Qt application under Wayland, you should export the following variables:

export QT_QPA_PLATFORM=wayland export QT_QPA_PLATFORMTHEME=qt5ct

Debug Messages:

By default, debug messages from platform plugin are disabled. To enable them, you should export the following environment variable:

export QT_LOGGING_RULES="qt5ct.debug=true"

Another way is to change qtlogging.ini file. See Qt documentation for details: https://doc.qt.io/qt-5/qloggingcategory.html (paragraph "Configuring Categories")

Files and Directories:

qt5ct - Qt5 configuration tool libqt5ct.so - qt5ct platform plugin libqt5ct-style.so - qt5ct proxy style plugin ~/.config/qt5ct/qt5ct.conf - configuration file ~/.config/qt5ct/qss, ~/.local/share/qt5ct/qss, /usr/share/qt5ct/qss, /usr/local/share/qt5ct/qss - style sheets ~/.config/qt5ct/colors,~/.local/share/qt5ct/colors, /usr/share/qt5ct/colors, /usr/local/share/qt5ct/colors - color schemes /etc/xdg/qt5ct/qt5ct.conf - default configuration file

Translation:

Use Transifex service: https://www.transifex.com/projects/p/qt5ct/