{"id":45629,"date":"2024-02-23T13:55:55","date_gmt":"2024-02-23T13:55:55","guid":{"rendered":"https:\/\/ubuntuhandbook.org\/?p=45629"},"modified":"2025-10-14T10:43:10","modified_gmt":"2025-10-14T10:43:10","slug":"install-kvantum-ubuntu","status":"publish","type":"post","link":"https:\/\/ubuntuhandbook.org\/index.php\/2024\/02\/install-kvantum-ubuntu\/","title":{"rendered":"How to Install Kvantum to Theme Qt6\/Qt5 Apps in Ubuntu"},"content":{"rendered":"<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"alignleft size-thumbnail wp-image-39672\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo-250x250.webp\" alt=\"\" width=\"250\" height=\"250\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo-250x250.webp 250w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo-300x300.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo-600x600.webp 600w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo-768x768.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2020\/07\/qt-logo.webp 1200w\" sizes=\"auto, (max-width: 250px) 100vw, 250px\" \/><\/a><\/p>\n<p>This simple tutorial shows how to install and use Kvantum theme engine to change themes for your Qt5 and Qt6 applications in Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, Ubuntu 25.04, and 25.10.<\/p>\n<p>GNOME Desktop uses GTK toolkit for its applications and KDE\/LxQt uses Qt toolkit instead. These apps work on each other desktop environment, but may NOT look native.<\/p>\n<p>To unify the look and feel, <a href=\"https:\/\/github.com\/FedoraQt\" target=\"_blank\" rel=\"noopener\">Fedora Qt developer team<\/a> has <code>QGnomePlatform<\/code>, <code>adwaita-qt<\/code>, and <code>QAdwaitaDecorations<\/code> projects to make Qt apps look better in GNOME. So far, only <code>QAdwaitaDecorations<\/code> is in active development for implementing Adwaita-like window header and border for Qt apps.<\/p>\n<p>For Qt app window color, buttons, and other components, <a href=\"https:\/\/github.com\/tsujan\/Kvantum\" target=\"_blank\" rel=\"noopener\">Kvantum<\/a> is good choice to do the job.<\/p>\n<div id=\"attachment_45630\" style=\"width: 620px\" class=\"wp-caption aligncenter\"><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum.webp\"><img loading=\"lazy\" decoding=\"async\" aria-describedby=\"caption-attachment-45630\" class=\"size-large wp-image-45630\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-700x475.webp\" alt=\"\" width=\"610\" height=\"414\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-700x475.webp 700w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-300x203.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-768x521.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-1536x1042.webp 1536w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum-1320x895.webp 1320w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/qbittorrent-kvantum.webp 1575w\" sizes=\"auto, (max-width: 610px) 100vw, 610px\" \/><\/a><p id=\"caption-attachment-45630\" class=\"wp-caption-text\">qBittorrent (Qt6) with Kvantum theme in Ubuntu<\/p><\/div>\n<p><!--more--><\/p>\n<p>Many apps have been ported to (and even built with) Qt6, but Ubuntu so far only includes the theme engine in system repositories for Qt5. So I&#8217;m here to show you how to install and use the Qt6 version.<\/p>\n<h3>Step 1: Install Kvantum theme engine<\/h3>\n<p>The popular Papirus icon theme project maintains an <a href=\"https:\/\/launchpad.net\/~papirus\/+archive\/ubuntu\/papirus\" target=\"_blank\" rel=\"noopener\">Ubuntu PPA<\/a> that contains the Kvantum packages for both Qt5 and Qt6. So far, it supports Ubuntu 22.04, Ubuntu 24.04, Ubuntu 25.10 and Ubuntu 25.04 on <code>amd64<\/code> (Intel\/AMD) platforms.<\/p>\n<p>1. First, press <code>Ctrl+Alt+T<\/code> on keyboard to open terminal. When it opens, run command to add the PPA:<\/p>\n<pre>sudo add-apt-repository ppa:papirus\/papirus<\/pre>\n<p><i>Type user password (no asterisk feedback) when it asks and hit Enter to continue.<\/i><\/p>\n<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-45631\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa-700x475.webp\" alt=\"\" width=\"610\" height=\"414\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa-700x475.webp 700w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa-300x203.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa-768x521.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/papirus-ppa.webp 786w\" sizes=\"auto, (max-width: 610px) 100vw, 610px\" \/><\/a><\/p>\n<p>2. After adding the PPA, Linux Mint user needs to manually refresh system package cache (it&#8217;s automatically done in Ubuntu while adding PPA).<\/p>\n<pre>sudo apt update<\/pre>\n<p>3. Finally, install the theme engine for both Qt5 and Qt6:<\/p>\n<pre>sudo apt install qt5-style-kvantum qt6-style-kvantum<\/pre>\n<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-45632\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum-700x446.webp\" alt=\"\" width=\"610\" height=\"389\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum-700x446.webp 700w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum-300x191.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum-768x489.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/apt-qt6-style-kvantum.webp 894w\" sizes=\"auto, (max-width: 610px) 100vw, 610px\" \/><\/a><\/p>\n<h3>Step 2: Set Environment Variable for Kvantum<\/h3>\n<p>Before being able to change Qt app theme through Kvantum, you may either run command to set the environment variable:<\/p>\n<pre>export QT_STYLE_OVERRIDE=kvantum<\/pre>\n<p>After that, any Qt5\/Qt6 apps start from command line in this terminal window will take use the Kvantum theme engine.<\/p>\n<p>To make it permanently, open Home folder, press <b>Ctrl+H<\/b> to view hidden files and folders. Then, click edit the <b>.profile<\/b> file, and add new line below in the end:<\/p>\n<pre>export QT_STYLE_OVERRIDE=kvantum<\/pre>\n<p><i>For Fedora, Arch, etc, edit <code>.bash_profile<\/code> or <code>.bash_login<\/code> file instead. <strong>You may add new line <code>export QT_QPA_PLATFORM=\"xcb;wayland\"<\/code> for Gnome style window header and border.<\/strong><\/i><\/p>\n<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-45633\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env-700x338.webp\" alt=\"\" width=\"610\" height=\"295\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env-700x338.webp 700w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env-300x145.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env-768x371.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-env.webp 1228w\" sizes=\"auto, (max-width: 610px) 100vw, 610px\" \/><\/a><\/p>\n<p>Finally, log out and back in to apply change.<\/p>\n<h3>Step 3: use Kvantum to change theme<\/h3>\n<p>Now, you can search for and open <code>kvantnum manager<\/code> from either start menu or &#8216;Activities&#8217; overview depends on your desktop environment.<\/p>\n<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/launch-kvantum.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-full wp-image-45634\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/launch-kvantum.webp\" alt=\"\" width=\"558\" height=\"274\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/launch-kvantum.webp 558w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/launch-kvantum-300x147.webp 300w\" sizes=\"auto, (max-width: 558px) 100vw, 558px\" \/><\/a><\/p>\n<p>Finally, go to &#8220;Change\/Delete Theme&#8221; page to select a theme for your Qt apps, and navigate to &#8220;Configure Active Theme&#8221; page for more detailed options for current them.<\/p>\n<p>The changes apply immediately in the &#8220;Kvantum Manager&#8221; app window, but other Qt apps need a restart to apply.<\/p>\n<p><a href=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager.webp\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter size-large wp-image-45635\" src=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager-700x390.webp\" alt=\"\" width=\"610\" height=\"340\" srcset=\"https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager-700x390.webp 700w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager-300x167.webp 300w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager-768x428.webp 768w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager-1320x736.webp 1320w, https:\/\/ubuntuhandbook.org\/wp-content\/uploads\/2024\/02\/kvantum-manager.webp 1390w\" sizes=\"auto, (max-width: 610px) 100vw, 610px\" \/><\/a><\/p>\n<h3>Uninstall:<\/h3>\n<p>To remove the theme engine, open terminal (Ctrl+Alt+T) and run command:<\/p>\n<pre>sudo apt remove --autoremove qt*-style-kvantum<\/pre>\n<p>Also remove the Ubuntu PPA by running command:<\/p>\n<pre>sudo add-apt-repository --remove ppa:papirus\/papirus<\/pre>\n<p>You may also remove the <code>export<\/code> line in the end of <code>.profile<\/code> file.<\/p>","protected":false},"excerpt":{"rendered":"<p>This simple tutorial shows how to install and use Kvantum theme engine to change themes for your Qt5 and Qt6 applications in Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04, Ubuntu 25.04, and 25.10. GNOME Desktop uses GTK toolkit for its applications and KDE\/LxQt uses Qt toolkit instead. These apps work on each other desktop environment, but [&hellip;]<\/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,2154,2155],"class_list":["post-45629","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howtos","tag-qt","tag-qt6","tag-theme"],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/45629","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=45629"}],"version-history":[{"count":0,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/posts\/45629\/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=45629"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/categories?post=45629"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ubuntuhandbook.org\/index.php\/wp-json\/wp\/v2\/tags?post=45629"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}