{"id":49820,"date":"2025-10-13T08:25:51","date_gmt":"2025-10-13T08:25:51","guid":{"rendered":"https:\/\/ubuntuhandbook.org\/?p=49820"},"modified":"2025-10-14T10:36:27","modified_gmt":"2025-10-14T10:36:27","slug":"theme-qt-apps-ubuntu","status":"publish","type":"post","link":"https:\/\/ubuntuhandbook.org\/index.php\/2025\/10\/theme-qt-apps-ubuntu\/","title":{"rendered":"Fix Qt App Window Border & Title-bar in Ubuntu 24.04 | 25.10"},"content":{"rendered":"

\"\"<\/p>\n

Qt applications (e.g, qBittorrent, KeePassXC) look weird as they don’t have window border or shadow in Ubuntu since 24.04. Here’s how to configure to make them look native<\/b>.<\/p>\n

Applications in Ubuntu and other popular Linux distributions mostly use GTK or Qt tool-kits for rendering their user interfaces. Gnome is based on GTK. It uses “xcb” QPA plugin for Qt apps running on classic Xorg session.
\n<\/p>\n

Due to switch to Wayland, the “xcb” plugin is not in use by default, and Qt apps look weird as you see in the screenshot below in Ubuntu 24.04, Ubuntu 25.04 & 25.10.<\/p>\n

\"\"

Qt apps look border-less in Ubuntu since 24.04<\/p><\/div>\n

To “fix” the issue, I found few choices:<\/p>\n

    \n
  1. Re-use “xcb” QPA plugin.<\/li>\n
  2. QGnomePlatform theme.<\/li>\n
  3. QAdwaitaDecorations Qt decoration plugin.<\/li>\n<\/ol>\n

    While there are also Qt5\/6 configuration tool and Kvantum available for configuring Qt theme, icon, font, color, and more.<\/p>\n

    1. “Fix” Qt window title-bar and window border<\/h3>\n

    Option 1: use “xcb” QPA plugin<\/h4>\n

    Most Qt applications (both Qt5 and Qt6) are still working good with “xcb” QPA plugin even in Wayland session.<\/p>\n

    1.<\/b> First, press Ctrl+Alt+T<\/code> on keyboard to open window. When it opens, run command to install the required libraries:<\/p>\n

    sudo apt install libxcb-cursor0 libxcb-composite0<\/pre>\n
    Run sudo apt update<\/code> to refresh cache in case it’s unable to locate the packages<\/i>.<\/p>\n
    \"\"<\/p>\n
    2.<\/b> After that, run the command below in terminal to set the environment variable:<\/p>\n
    export QT_QPA_PLATFORM=xcb<\/pre>\n
    Then, all Qt apps start from that terminal window will try using “xcb” plugin. For example, run keepassxc<\/code> to start the Qt-based password manager.<\/p>\n
    \"\"
    enable ‘xcb’ for apps start from this terminal only<\/p><\/div>\n
    3.<\/b> If it works for you, then open Files (aka Nautilus), and press Ctrl+H<\/b> to show all hidden files. Find out .profile<\/b> file in home directory and click edit it.<\/p>\n
    Finally, add export QT_QPA_PLATFORM=”xcb;wayland”<\/b> in the end of file to make it work for all Qt applications permanently! And, log out and back<\/em> in to apply.<\/p>\n
    \"\"<\/a>
    enable xcb for all Qt apps, though current user only<\/p><\/div>\n
    NOTE:<\/b> It must be set to “xcb;wayland<\/code>“, to allow fall-back to default wayland, when ‘xcb’ does not work. For example, Qt apps installed as Flatpak may not work with ‘xcb’ plugin and output the error below:<\/p>\n
    qt.qpa.xcb: could not connect to display
    \nqt.qpa.plugin: From 6.5.0, xcb-cursor0 or libxcb-cursor0 is needed to load the Qt xcb platform plugin.
    \nqt.qpa.plugin: Could not load the Qt platform plugin “xcb” in “” even though it was found.<\/p><\/blockquote>\n
    \"\"<\/a><\/p>\n
    Option 2: Use QGnomePlatform theme<\/h4>\n
    While xcb is designed for Xorg, FedoraQt team<\/a> has developed few Qt plugins for better integration in GNOME. They are “QGnomePlatform” theme, “adwaita-qt” style, and “QAdwaitaDecorations”.<\/p>\n
    Downsides:<\/b> The Qt window title-bar made by QGnomePlatform looks NOT so good. FedoraQt has discontinued the project. And, Ubuntu 24.04 only includes Qt5 version of the package.<\/p>\n
    1.<\/b> To install the Qt platform theme, open terminal (Ctrl+Alt+T) and run command:<\/p>\n
    sudo apt install qgnomeplatform-qt5<\/pre>\n
    Ubuntu 25.04, 25.10 may also install qgnomeplatform-qt6<\/code> for Qt6 support.<\/p>\n
    \"\"<\/a><\/p>\n
    2.<\/b> Next, either run the command below to set environment:<\/p>\n
    export QT_QPA_PLATFORMTHEME='gnome'<\/pre>\n
    Then, start Qt apps from the same terminal window to use the Qt platform theme.<\/p>\n
    \"\"<\/a><\/p>\n
    Or, edit .profile<\/b> file in home directory and add export QT_QPA_PLATFORMTHEME='gnome'<\/code> to make it work permanently for all Qt apps (Qt5 only for 24.04) at next login.<\/p>\n
    \"\"<\/a><\/p>\n
    Option 3: Use QAdwaitaDecorations<\/h4>\n
    QGnomePlatform and adwaita-qt have been discontinued (though they still work). QAdwaitaDecorations, the project that implements Adwaita-like client-side decorations, is so far the only upstream project that’s still in development.<\/p>\n
    However, it’s NOT made into Debian\/Ubuntu repositories so far. Meaning you need to build it by yourself. And, it does not support Qt6 app for Ubuntu 24.04, as it requires Qt6 >= 6.5.0 (24.04 has 6.4.2).<\/p>\n
    This option is good choice for Ubuntu 25.10, to enable Qt5 window decorations, while Qt6 decorations work out-of-the-box.<\/b><\/p>\n
    1.<\/b> First, open terminal (Ctrl+Alt+T) and run command to install dependency libraries:<\/p>\n
    sudo apt install git cmake build-essential qtbase5-dev libqt5svg5-dev libqt5waylandclient5-dev qtbase5-private-dev qtwayland5-private-dev libwayland-dev<\/pre>\n
    \"\"<\/p>\n
    2.<\/b> Then, run command to grab the source code<\/a>:<\/p>\n
    git clone https:\/\/github.com\/FedoraQt\/QAdwaitaDecorations.git<\/pre>\n
    After that, navigate to the source folder, create ‘build’ sub-folder and navigate into it:<\/p>\n
    cd QAdwaitaDecorations<\/pre>\n
    mkdir build && cd build<\/pre>\n
    Next, configure the source for Qt5:<\/p>\n
    cmake -DUSE_QT6=OFF ..\/<\/pre>\n
    Ubuntu 24.04 does NOT meet Qt6 requirement, and Qt6 window decoration in 25.10 looks good out-of-the-box, so here I only build it for Qt5.<\/p>\n
    \"\"<\/p>\n
    3.<\/b> Finally, build & install the plugin by running the 2 commands below one by one:<\/p>\n
    make -j3<\/pre>\n
    sudo make install<\/pre>\n
    Here -j3<\/code> tells to start 3 threads in parallel. Depends on how many CPU cores you have, you may replace it with -j4<\/code>, -j8<\/code>, or j$(nproc)<\/code> to use all CPU cores.<\/p>\n
    \"\"<\/p>\n
    4<\/b>. After successfully built the plugin, clean up by deleting the source folder. Then, either run the command below to set environment variable:<\/p>\n
    export QT_WAYLAND_DECORATION=adwaita<\/pre>\n
    So it works for all Qt5 apps start from this terminal window.<\/p>\n
    \"\"<\/p>\n
    Or, edit .profile<\/b> file in user home and add the line to make it work permanently for all Qt5 apps at next login.<\/p>\n
    \"\"<\/p>\n
    2. Change Qt Theme, or Configure Fonts, icon, and colors<\/h3>\n
    Gnome\/Adwaita style decorations is NOT enough? You may also configure the Qt apps themes, fonts, icons, and color scheme.<\/p>\n
    Option 1: Use Kvantum along with “xcb”<\/h4>\n
    If you use “xcb” plugin for the decorations, then you may also use Kvantum (SVG-based theme engine) to change the Qt app themes.<\/p>\n
    1. First, open terminal (Ctrl+Alt+T) and run command to install the package:<\/p>\n
    sudo apt install qt5-style-kvantum<\/pre>\n
    Ubuntu 25.04, 25.10 users may also install qt6-style-kvantum<\/code> for Qt6 apps support, however it’s NOT available in Ubuntu 24.04.<\/p>\n
    \"\"<\/p>\n
    2. Next, set the following environment variables:<\/p>\n
    export QT_QPA_PLATFORM=\"xcb;wayland\"\r\nexport QT_STYLE_OVERRIDE=kvantum<\/pre>\n
    either in terminal for apps start from that terminal, or in .profile<\/b> for all Qt apps (Qt5 only for 24.04).<\/p>\n
    3. Finally, launch “Kvantum Manager” to change Qt theme and configure active theme.<\/p>\n
    \"\"<\/a><\/p>\n
    Use qt5ct \/ qt6ct<\/h4>\n
    For choice, you may use Qt5 \/ Qt6 settings tools to configure the app window buttons, fonts, icons, and color scheme.<\/p>\n
    1. First, open terminal and install the settings tools, as well as adwaita-qt themes:<\/p>\n
    sudo apt install qt5ct qt6ct adwaita-qt adwaita-qt6<\/pre>\n
    \"\"<\/a><\/p>\n
    2. Next, set environment variable:<\/p>\n
    export QT_QPA_PLATFORMTHEME=qt5ct<\/pre>\n
    It works for both Qt5 and Qt6 with either “xcb” or “wayland” QPA platform.<\/p>\n
    \"\"<\/a><\/p>\n
    3. After set the environment (log out and back in if added to .profile<\/code>), launch Qt5 Settings or Qt6 settings to configure the Qt appearances.<\/p>\n
    \"\"<\/a><\/p>\n
    Summary:<\/h3>\n
    This tutorial shows how to “fix” border-less issue for Qt apps in Ubuntu 24.04 and higher with default GNOME, as well as change the theme, fonts, icons, and color scheme.<\/p>\n
    The “xcb” QPA platform plugin is still a good choice for 24.04 with both Qt5 and Q6 support. While, QAdwaitaDecorations is better (in my own opinion) for Qt5 in 25.10, as Qt6 decorations look good out-of-the-box.<\/p>","protected":false},"excerpt":{"rendered":"
    Qt applications (e.g, qBittorrent, KeePassXC) look weird as they don’t have window border or shadow in Ubuntu since 24.04. Here’s how to configure to make them look native. Applications in Ubuntu and other popular Linux distributions mostly use GTK or Qt tool-kits for rendering their user interfaces. Gnome is based on GTK. It uses “xcb” […]<\/p>\n","protected":false},"author":1,"featured_media":39672,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[1350,2155],"class_list":["post-49820","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","tag-qt","tag-theme"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/49820","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/comments?post=49820"}],"version-history":[{"count":0,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/49820\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/media\/39672"}],"wp:attachment":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/media?parent=49820"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/categories?post=49820"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/tags?post=49820"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}