Export translations

Settings

Group

Language

Format

Export for off-line translation

Export in native format

<languages/>
__TOC__

<div lang="en" dir="ltr" class="mw-content-ltr">
=Overview=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
'''LXQt''' is a free and open source lightweight Qt desktop environment that was formed from the merger of the [[Install Desktop Environments#LXDE|LXDE]] and Razor-qt projects. It is focused on being a classic desktop with a modern look and feel. The official website for LXQt can be accessed [https://lxqt-project.org/ here].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Installation=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Instructions for installing LXQt can be found on the [[Install_Desktop_Environments#LXQt|Install Desktop Environments]] page.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Window Managers=
LXQt is designed to be used with any window manager and does not provide one by its own.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
See article [[LXQt_with_kwin]]
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Configuration=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
LXQt provides the '''lxqt-config''' (LXQt Settings) application for configuration.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Global Keyboard Shortcuts==
Global shortcuts can be configured by the '''lxqt-config-globalkeyshortcuts''' application (LXQt settings -> Global Shortcuts):
    <Screenshot TBD>
{{BoxDanger|warning|Mapping the Super_L/Super_R keys (<Meta> without a second key) can lead to unexpected behaviour and is not recommended!}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{BoxInfo|note|Some window manager (kwin, openbox, etc.) specific shortcuts are not configurable by LXQt (e.g. "Alt+Tab" for the task switcher). Those are configured by the window manager.}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=Theming=
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In can take a few steps to get everything matching on LXQt since it is a collection of things.  There are a few different things that are separately themed:
* GTK2/GTK3
* QT
* Openbox
* LXQt panels
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Kvantum==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Using Kvantum is a good way to get a matching qt5 and openbox theme with a modern look
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To install Kvantum and set a theme that matches your preferences follow the instructions [[Kvantum|here]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
After saving the settings in Kvantum Manager, open the "LXQt Configuration Center" and select "Appearance".  Set the "Qt Style" on the "Widgets Style" tab to Kvantum.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|Using a Kvantum theme that has a matching GTK theme will give everything a uniform look}}
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Window Theming==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The window title bars are drawn onto your screen by the window manager you use. The default window manager of LXQt is Openbox.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
To configure OpenBox, open the "LXQt Configuration Center" and select "Openbox Settings".  Then select the same theme you choose in Kvantum.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==GTK Theming==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
LXQt now provides an easy way to set the themes for GTK2 and GTK3 applications.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Open the "LXQt Configuration Center" and select "Appearance".  On the "Widget Style" there are dropdowns to select the GTK styles.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Panel Theming==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Panel theming is available via the LXQt Configuration Center --> LXQt Appearance --> LXQt Theme
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Change Mouse Cursor==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Mouse cursor theming is available via the LXQt Configuration Center --> LXQt Appearance --> Cursor.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
<code>Adwaita</code> is the default mouse cursor theme in LXQt. Other mouse cursor themes can be downloaded. Example of a mouse cursor theme:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
sudo pacman -S xcursor-menda
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Change Icon Theme==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The icon theme can be changed via LXQt Configuration Center --> LXQt Appearance --> Icon Theme
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The default icon theme of LXQt is ''oxygen-icons''. It is a relatively large download, but pretty complete.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Change Icons of Applications and System Settings==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The path of icons is saved in <code>.desktop</code> files. For each application you can find their corresponding <code>.desktop</code> files in one of these two locations:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
/usr/share/applications/
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
~/.local/share/applications/
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Note that all folder names beginning with a dot are hidden folders. You need to make them visible by clicking <code>View --> Show Hidden</code> in your PcManFM-Qt File Browser. The <code>~</code> directory is your home folder.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Open a <code>.desktop</code> 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 <code>=</code> symbol. A lot of system icons can be found in this location:
 /usr/share/icons/
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Example:===
If you want to use a flag icon, use this line in the <code>.desktop</code> file:
 Icon=/usr/share/icons/gnome/48x48/apps/locale.png
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Create Custom Icon on Panel==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Right click on your panel and choose "Add panel widget". Then add a Quick Launch / Starter widget. A text will appear on your panel.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
You can drag and drop any icon (from your start menu / mainmenu or your custom icon file) there in order to create a Quick Launch / Starter icon in your panel. You can even drop multiple icons / icon files on one Quick Launch / Starter widget.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
But if you want your custom icon in your panel, you must first create your own <code>.desktop</code> file (please keep reading).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
===Example:===
For demonstration purposes, let's create a custom icon, which will shut down our computer when clicked:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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 <code>ShutDown.desktop</code>. You can choose any name you want, but the <code>.desktop</code> in the end is important.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Next, edit this file with a text editor. It's file content is supposed to look like:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
[Desktop Entry]
 Type=Application
 Name=ShutDown
 Comment=Shut down my computer
 Exec=poweroff
 Icon=/usr/share/icons/Menda-Circle/actions/scalable/bottom.svg
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
* <code>Name=</code> is the name of the icon
* <code>Comment=</code> gets shown when you hover with your mouse cursor over the icon
* <code>Exec=</code> defines the terminal command, which is executed when the icon is clicked
* <code>Icon=</code> specifies the path to the icon
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Finally, you can drag and drop your custom icon file onto a Quick Launch / Starter widget in your panel (as described in the beginning of this chapter) to create your custom panel icon.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Create Custom Icon in Start Menu / Mainmenu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Read the [https://wiki.manjaro.org/index.php?title=LXQt_Theming#Create_Custom_Icon_on_Panel previous chapter] of this Wiki tutorial in order to get familiar with the content of <code>.desktop</code> files.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Now, a custom <code>.desktop</code> files needs to get created (as root) in this location:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
/usr/share/applications/
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Please look at other <code>.desktop</code> files as examples for the <code>.desktop</code> file content: All have a category specified, e.g.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Categories=Qt;KDE;Settings;
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
This setting is important for the Start Menu / Mainmenu category this custom icons appears in. Use it.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Another important line in the <code>.desktop</code> file is:
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
OnlyShowIn=LXQt;
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If this is set to another desktop environment, set it to LXQt or delete this line entirely in order to see this custom icon in your Start Menu / Mainmenu.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Change Order of Icons on Panel==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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 <code>CTRL+Left Mouse</code> and draging the element. These methods work for all panel elements, except Quick Launch / Starter elements with added icons.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Quick Launch / Starter elements have "Move Left" and "Move Right" as right click options, which do enable you to freely move it. Just click the "Remove from quicklaunch" in order to remove the icon from the Quick Launch Widget.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Now, you can move the Quick Launch Widget like all other panel elements. After you have moved the Quick Launch Widget to the desired position on your panel, follow [https://wiki.manjaro.org/index.php?title=LXQt_Theming&action=edit#Create_Custom_Icon_on_Panel this tutorial] to add your icon again.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Change Icon of Start Menu / Mainmenu==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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 <code>System Settings&gt;LXQT Configuration Center&gt;LXQtAppearance&gt;LXQt Theme</code>. The Start Menu icon will only get changed for <theme name>. All other themes still use the default icon!
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
In this folder, you find a <code>mainmenu.png</code> 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.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Great icons can be found in this thread: https://forum.manjaro.org/index.php?topic=15613.0
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
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
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=See Also=
* You can find more pages about LXQt in the Manjaro Wiki [https://wiki.manjaro.org/index.php?title=Desktop_Environments#LXQt here].
</div>

[[Category:Contents Page{{#translation:}}]]
[[Category:Editions{{#translation:}}]]