LXQt
Views
Actions
Namespaces
Variants
Tools
This wiki page is about theming your LXQt installation.
Window Title Bar Theming
The window title bars are drawn onto your screen by the window manager you use. The default window manager of LXQt is Openbox.
The Openbox Configuration Manager can be opened: Start Menu --> Settings --> Openbox Configuration Manager
If you lack the Openbox Configuration Manager, please install it:
sudo pacman -S obconf
Or better, install the qt version of obconf included in repolxqt:
sudo pacman -S obconf-qt-git
But if you've not installed LXQt from the install media you first need to enable repolxqt, or install the AUR package:
yaourt -S obconf-qt-git
Then please choose your preferred window title bar theme in Openbox Configuration Manager .
Additional themes can be downloaded. Examples:
sudo pacman -S menda-themes-dark
sudo pacman -S menda-themes
yaourt -S mediterraneannight-theme
Alternatively, follow this guide to install a more modern window manager with higher hardware resources: LXQt with kwin
Window Content Theming
This section is about theming the content of you windows. Especially the background and font colors, but also the form of menus and buttons.
Instructions to have a unified theme for all your GTK2/3/Openbox and Qt4/5 applications and be able to customize them:
1.
Choose GTK+
in lxqt-config
(LXQt Configuration Center --> LXQt Appearance)
2.
Install the LXDE theme switcher:
sudo pacman -S lxappearance
Open it by clicking on: Start Menu --> Settings --> Appearance.
Unfortunately, this functionality is not implemented in LXQt yet. Therefore, the LXDE theme switcher is still needed.
3.
Install well maintained themes supporting GTK2/3 and Openbox
Examples:
sudo pacman -S menda-themes-dark
sudo pacman -S menda-themes
yaourt -S vertex-themes
4.
For customising a pure Qt4/5 system you can use the preinstalled qtconfig-qt4 and its qt5 version, qt5ct which you can easily compile. In addition to the preinstalled qt theme engines you can install qtcurve-qt4
and qtcurve-qt5
from the repo by:
sudo pacman -S qtcurve-qt4 qtcurve-qt5
And you can install virtuality
AUR packages by:
yaourt -S virtuality-qt4-git virtuality-qt5-git
Those two theming engines by themselves have some customisability too. With qtcurve
you need to manually edit the ~/.config/qtcurve/stylerc
file.
Panel Theming
Panel theming is available via the LXQt Configuration Center --> LXQt Appearance --> LXQt Theme
Additionally there are more themes available for download in the Manjaro LXQt subforum. All Theme folders need to be unpacked into the following directory:
/usr/share/lxqt/themes/
Attention: Some themes do not fully work. Please read the comments about the recommended usage.
Example:
Please look at this Chrome theme.
The downloaded folder needs to be unpacked and moved into the right location mentioned above. The final path to the "chrome" folder has to be
/usr/share/lxqt/themes/chrome/
Change Mouse Cursor
Mouse cursor theming is available via the LXQt Configuration Center --> LXQt Appearance --> Cursor.
Adwaita
is the default mouse cursor theme in LXQt. Other mouse cursor themes can be downloaded. Example of a mouse cursor theme:
sudo pacman -S xcursor-menda
Change Icon Theme
The icon theme can be changed via LXQt Configuration Center --> LXQt Appearance --> Icon Theme
The default icon theme of LXQt is oxygen-icons. It is a relatively large download, but pretty complete.
Examples of other icon themes are:
sudo pacman -S menda-circle-icon-theme
yaourt -S numix-icon-theme-git
sudo pacman -S faenza-icon-theme
yaourt -S tango-icon-theme
All of these example do not provide complete icon themes. Especially in the LXQt Configuration Center are icons missing. Some application icons can be missing, too. You can easily identify applications and settings with missing icons by opening the start menu and looking at all the icons in it.
Please read the next chapter (chapter 5) for a tutorial on how to assign new/other icons.
Change Icons of Applications and System Settings
The path of icons is saved in .desktop
files. For each application you can find their corresponding .desktop
files in one of these two locations:
/usr/share/applications/
~/.local/share/applications/
Note that all folder names beginning with a dot are hidden folders. You need to make them visible by clicking View --> Show Hidden
in your PcManFM-Qt File Browser. The ~
directory is your home folder.
Open a .desktop
file with a text editor with root privileges and look for the following line:
Icon=
Insert the path to the icon you want to use after the =
symbol. A lot of system icons can be found in this location:
/usr/share/icons/
Example:
If you want to use a flag icon, use this line in the .desktop
file:
Icon=/usr/share/icons/gnome/48x48/apps/locale.png
Create Custom Icon on Panel
Right click on your panel and choose "Add panel widget". Then add a Quick Launch / Starter widget. A text will appear on your panel.
You can drag and drop any icon file (from your start menu / mainmenu or your custom icon file) there in order to create a Quick Launch / Starter icon in your panel. But if you want your custom icon in your panel, you must first create your own .desktop
file (as you can read in the last chapter of this tutorial).
For demonstration purposes, let's create a custom icon, which will shut down our computer when clicked:
First, let's create a new file (e.g. in your home directory or any other directory you want): Right click and choose "Create New" --> "Blank File". Name the file ShutDown.desktop
. You can choose any name you want, but the .desktop
in the end is important.
Next, edit this file with a text editor:
[Desktop Entry] Type=Application Name=ShutDown Comment=Shut down my computer Exec=poweroff Icon=/usr/share/icons/Menda-Circle/actions/scalable/bottom.svg
Name=
is the name of the iconComment=
gets shown when you hover with your mouse cursor over the iconExec=
defines the terminal command, which is executed when the icon is clickedIcon=
specifies the path to the icon
Finally, you can drag and drop your custom icon file onto the panel (as described in the beginning of this chapter) to create your custom icon.
Change Order of Icons on Panel
You can click the right mouse button on top of a panel element in order to move it. Alternatively, you can move panel elements by holding CTRL+Left Mouse
and draging the element. These methods work for all panel elements, except Quick Launch / Starter elements.
If you want to move Quick Launch / Starter elements on your panel, you need to manually edit a file. Open the following file in a text editor:
~/.config/lxqt/panel.conf
Note that all folder names beginning with a dot are hidden folders. You need to make them visible by clicking View --> Show Hidden in your PcManFM-Qt File Browser. The ~
directory is your home folder.
Please note the order of whole paragraphs beginning with [square brackets]
. Changing the order of whole paragraphs beginning with [square brackets]
does not move items on your panel. All paragraphs are sorted alphabetically. Pay attention to the paragraphs with the title [quicklaunch]
. This is the panel element, which contains multiple Quick Launch / Starter items.
The order of every Quick Launch / Starter item can be adjusted separately within the [quicklaunch]
. Simply changing the order of whole paragraphs beginning with [quicklaunch]
does not move Quick Launch / Starter items on your panel, you also need to rename them.
Example:
You have the following Quick Launch / Starter items:
[quicklaunch2] alignment=Left apps\1\desktop=/usr/share/applications/pcmanfm-qt.desktop apps\size=1 type=quicklaunch [quicklaunch3] alignment=Left apps\1\desktop=/usr/share/applications/qterminal.desktop apps\size=1 type=quicklaunch [quicklaunch4] alignment=Left apps\1\desktop=/usr/share/applications/firefox.desktop apps\size=1 type=quicklaunch
and you want to have the Mozilla Firefox icon on the left (of all these 3 icons). Please edit the file to look like this:
[quicklaunch2] alignment=Left apps\1\desktop=/usr/share/applications/firefox.desktop apps\size=1 type=quicklaunch [quicklaunch3] alignment=Left apps\1\desktop=/usr/share/applications/pcmanfm-qt.desktop apps\size=1 type=quicklaunch [quicklaunch4] alignment=Left apps\1\desktop=/usr/share/applications/qterminal.desktop apps\size=1 type=quicklaunch
Please restart your panel (see below) to see the changes. This method usually works, but not very precisely. Sometimes the order of Quick Launch / Starter icons is different than specified in the file. Deleting a Quick Launch / Starter item can help, but not always.
If you want to move Quick Launch / Starter item to the far left or right of the panel, please edit the paragraph belonging to the Quick Launch / Starter item and use one of the following lines:
alignment=Left alignment=Right
This Method works for all panel elements, but please keep in mind that all other panel elements, except Quick Launch / Starter elements can be moved by clicking the right mouse button on top of a panel element in order to move it.
In order to see the changes logout and log in again. If you want to see the changes immediately run the following commands:
killall lxqt-panel lxqt-panel
Sometimes, executing lxqt-panel
is enough to reload the panel.
This Icon can be changed by opening the following folder with root privileges:
/usr/share/lxqt/themes/<theme name>/
Replace <theme name> with the name of the theme you are currently using. The name of your current theme can be found in System Settings>LXQT Configuration Center>LXQtAppearance>LXQt Theme
. The Start Menu icon will only get changed for <theme name>. All other themes still use the default icon!
In this folder, you find a mainmenu.png
file. It is the icon of your Start Menu (called "Mainmenu" in LXQt). Replace this file with the icon file you want to use. Rename your icon file to the same name.
Great icons can be found in this thread: https://forum.manjaro.org/index.php?topic=15613.0
In order to see the changes logout and log in again. If you want to see the changes immediately run the following commands:
killall lxqt-panel lxqt-panel
Links
You can find more pages about LXQt in the Manjaro Wiki here.