Manjaro

Difference between revisions of "LXQt"

imported>Excalibur1234
(added new paragraph)
Tags: Mobile web edit Mobile edit
 
(45 intermediate revisions by 8 users not shown)
Line 1: Line 1:
<languages/>
__TOC__


This wiki page is about theming your LXQt installation.
<translate>
=Overview= <!--T:1-->


<!--T:2-->
'''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].


__TOC__


<!--T:3-->
[[File: Lxqt-de-18.png|left|600px]]
<div style="clear: both"></div>


=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.
=Installation= <!--T:4-->


The Openbox configuration tool can be opened: Start Menu --> Settings --> Openbox Settings
<!--T:5-->
Instructions for installing LXQt can be found on the [[Install_Desktop_Environments#LXQt|Install Desktop Environments]] page.


If you lack the Openbox configuration tool, please install it:


sudo pacman -S obconf
=Window Managers= <!--T:6-->
LXQt is designed to be used with any window manager and does not provide one by its own.


Please choose your preferred window title bar theme from there. Additional themes can be downloaded. An attractive dark theme is:


yaourt -S mediterraneannight-theme
==KWin== <!--T:7-->


<!--T:8-->
See article [[LXQt_with_kwin]]


Alternatively, follow this guide to install a more modern window manager with higher hardware resources: [[LXQt with kwin]]


=Configuration= <!--T:9-->


=Window Content Theming=
<!--T:10-->
LXQt provides the '''lxqt-config''' (LXQt Settings) application for configuration.


This section is about theming the content of you windows. Especially the background and font colors, but also the form of menus and buttons.
==Global Keyboard Shortcuts== <!--T:11-->
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!}}


<!--T:12-->
{{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.}}


Instructions to have a unified theme for all your GTK2/3/Openbox and Qt4/5 applications and be able to customize them:


===1.===
=Theming= <!--T:13-->
Choose <code>GTK+</code> in <code>lxqt-config</code> (LXQt Configuration Center --> LXQt Appearance)


===2.===
<!--T:14-->
Install the LXDE theme switcher:
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:
sudo pacman -S lxappearance
* GTK2/GTK3
Open it by clicking on: Start Menu --> Settings --> Appearance.
* QT
* Openbox
* LXQt panels


Unfortunately, this functionality is not implemented in LXQt yet. Therefore, the LXDE theme switcher is still needed.


===3.===
==Kvantum== <!--T:15-->
Install well maintained themes supporting [http://gnome-look.org/index.php?xcontentmode=167 GTK2/3] and [http://box-look.org/index.php?xcontentmode=7402 Openbox]


<!--T:16-->
Using Kvantum is a good way to get a matching qt5 and openbox theme with a modern look


Examples:


yaourt -S vertex-themes
<!--T:17-->
To install Kvantum and set a theme that matches your preferences follow the instructions [[Kvantum|here]].


sudo pacman -S menda-themes


sudo pacman -S menda-themes-dark
<!--T:18-->
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.


===4.===
Edit manually the theme files to further customise if you like.


<!--T:19-->
{{tip|Using a Kvantum theme that has a matching GTK theme will give everything a uniform look}}




For a pure Qt4/5 system you don’t have really an option to choose a preset or customize the default one. You may use the default <code>fusion</code> and wait either for <code>qtcurve</code> or for <code>vitality</code> (<code>bespin</code> developer’s new creation) to have a config tool. Or another generous soul may create a qtconfig-qt5 in the mean time.
==Window Theming== <!--T:20-->


<!--T:21-->
The window title bars are drawn onto your screen by the window manager you use. The default window manager of LXQt is Openbox.


=Panel Theming=


Panel theming is available via the LXQt Configuration Center --> LXQt Appearance --> LXQt Theme
<!--T:22-->
To configure OpenBox, open the "LXQt Configuration Center" and select "Openbox Settings".  Then select the same theme you choose in Kvantum.


Additionally there are more themes available for download in the [https://forum.manjaro.org/index.php?board=20.0 Manjaro LXQt subforum].
All Theme folders need to be unpacked into the following directory:


/usr/share/lxqt/themes/
==GTK Theming== <!--T:23-->


Attention: Some themes do not fully work. Please read the comments about the recommended usage.
<!--T:24-->
LXQt now provides an easy way to set the themes for GTK2 and GTK3 applications.


===Example:===
Please look at this [https://forum.manjaro.org/index.php?topic=18058.msg165462#msg165462 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
<!--T:25-->
Open the "LXQt Configuration Center" and select "Appearance". On the "Widget Style" there are dropdowns to select the GTK styles.


/usr/share/lxqt/themes/chrome/




=Change Icon Theme=
==Panel Theming== <!--T:26-->


The icon theme can be changed via LXQt Configuration Center --> LXQt Appearance --> Icon Theme
<!--T:27-->
Panel theming is available via the LXQt Configuration Center --> LXQt Appearance --> LXQt Theme


The default icon theme of LXQt is ''oxygen-icons''. It is a relatively large download, but pretty complete.


==Change Mouse Cursor== <!--T:28-->


Examples of other icon themes are:
<!--T:29-->
Mouse cursor theming is available via the LXQt Configuration Center --> LXQt Appearance --> Cursor.


sudo pacman -S menda-circle-icon-theme
<!--T:30-->
<code>Adwaita</code> is the default mouse cursor theme in LXQt. Other mouse cursor themes can be downloaded. Example of a mouse cursor theme:


  yaourt -S numix-icon-theme-git
  <!--T:31-->
sudo pacman -S xcursor-menda


sudo pacman -S faenza-icon-theme


yaourt -S tango-icon-theme
==Change Icon Theme== <!--T:32-->


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.
<!--T:33-->
The icon theme can be changed via LXQt Configuration Center --> LXQt Appearance --> Icon Theme


Please read the next chapter (chapter 5) for a tutorial on how to assign new/other icons.
<!--T:34-->
The default icon theme of LXQt is ''oxygen-icons''. It is a relatively large download, but pretty complete.




=Change Icons of Applications and System Settings=
==Change Icons of Applications and System Settings== <!--T:35-->


<!--T:36-->
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:
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:


  /usr/share/applications/
  <!--T:37-->
/usr/share/applications/


  ~/.local/share/applications/
  <!--T:38-->
~/.local/share/applications/


<!--T:39-->
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.
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.




<!--T:40-->
Open a <code>.desktop</code> file with a text editor with root privileges and look for the following line:
Open a <code>.desktop</code> file with a text editor with root privileges and look for the following line:
  Icon=
  Icon=
Line 119: Line 142:




Example: if you want to use a flag icon, use this line in the <code>.desktop</code> file:
===Example:=== <!--T:41-->
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
  Icon=/usr/share/icons/gnome/48x48/apps/locale.png




=Change Order of Icons on Panel=
==Create Custom Icon on Panel== <!--T:42-->
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. If you want to do it manually by editing files, do the following:
 
<!--T:43-->
Right click on your panel and choose "Add panel widget". Then add a Quick Launch / Starter widget. A text will appear on your panel.
 
<!--T:44-->
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.
 
<!--T:45-->
But if you want your custom icon in your panel, you must first create your own <code>.desktop</code> file (please keep reading).
 
===Example:=== <!--T:46-->
For demonstration purposes, let's create a custom icon, which will shut down our computer when clicked:
 
<!--T:47-->
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.
 
<!--T:48-->
Next, edit this file with a text editor. It's file content is supposed to look like:
 
<!--T:49-->
[Desktop Entry]
Type=Application
Name=ShutDown
Comment=Shut down my computer
Exec=poweroff
Icon=/usr/share/icons/Menda-Circle/actions/scalable/bottom.svg
 
<!--T:50-->
* <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
 
 
<!--T:51-->
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.
 
 
==Create Custom Icon in Start Menu / Mainmenu== <!--T:52-->
 
<!--T:53-->
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.
 
<!--T:54-->
Now, a custom <code>.desktop</code> files needs to get created (as root) in this location:
 
<!--T:55-->
/usr/share/applications/
 
<!--T:56-->
Please look at other <code>.desktop</code> files as examples for the <code>.desktop</code> file content: All have a category specified, e.g.
 
<!--T:57-->
Categories=Qt;KDE;Settings;
 
<!--T:58-->
This setting is important for the Start Menu / Mainmenu category this custom icons appears in. Use it.
 
<!--T:59-->
Another important line in the <code>.desktop</code> file is:


<!--T:60-->
OnlyShowIn=LXQt;


You can modify the panel by opening the following file in a text editor:
<!--T:61-->
~/.config/lxqt/panel.conf
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.
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 <code>~</code> directory is your home folder.




Change the order of whole paragraphs beginning with <code>[square brackets]</code> to move items on your panel. In addition, use one of the following lines:
==Change Order of Icons on Panel== <!--T:62-->
alignment=Left
alignment=Right


Pay attention to the paragraph with the title <code>[quicklaunch]</code>. This is a panel element, which contains multiple quick launch items. it can only be moved as one element. The order of every quick launch item can be adjusted separately within the <code>[quicklaunch]</code> element.
<!--T:63-->
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.


<!--T:64-->
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.


In order to see the changes logout and log in again. If you want to see the changes immediately run the following commands:
<!--T:65-->
killall lxqt-panel
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.
lxqt-panel




=Change Icon of Start Menu / Mainmenu=
==Change Icon of Start Menu / Mainmenu== <!--T:66-->


<!--T:67-->
This Icon can be changed by opening the following folder with root privileges:  
This Icon can be changed by opening the following folder with root privileges:  
  /usr/share/lxqt/themes/<theme name>/
  /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!
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!


<!--T:68-->
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.
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.




<!--T:69-->
Great icons can be found in this thread: https://forum.manjaro.org/index.php?topic=15613.0
Great icons can be found in this thread: https://forum.manjaro.org/index.php?topic=15613.0




<!--T:70-->
In order to see the changes logout and log in again. If you want to see the changes immediately run the following commands:
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
  killall lxqt-panel
Line 161: Line 249:




=Links=
=See Also= <!--T:71-->
* You can find more pages about LXQt in the Manjaro Wiki [https://wiki.manjaro.org/index.php?title=Desktop_Environments#LXQt here].
</translate>


You can read more about LXQt in the Manjaro Wiki [https://wiki.manjaro.org/index.php?title=Desktop_Environments#LXQt here].
[[Category:Contents Page{{#translation:}}]]
[[Category:Editions{{#translation:}}]]

Latest revision as of 23:57, 27 July 2022

Other languages:
Deutsch • ‎English • ‎Türkçe • ‎русский • ‎فارسی

Overview

LXQt is a free and open source lightweight Qt desktop environment that was formed from the merger of the 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 here.


 


Installation

Instructions for installing LXQt can be found on the Install Desktop Environments page.


Window Managers

LXQt is designed to be used with any window manager and does not provide one by its own.


KWin

See article LXQt_with_kwin


Configuration

LXQt provides the lxqt-config (LXQt Settings) application for configuration.

Global Keyboard Shortcuts

Global shortcuts can be configured by the lxqt-config-globalkeyshortcuts application (LXQt settings -> Global Shortcuts): 

   <Screenshot TBD>
warning
Mapping the Super_L/Super_R keys (<Meta> without a second key) can lead to unexpected behaviour and is not recommended!


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.


Theming

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


Kvantum

Using Kvantum is a good way to get a matching qt5 and openbox theme with a modern look


To install Kvantum and set a theme that matches your preferences follow the instructions here.


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.



Tip
Using a Kvantum theme that has a matching GTK theme will give everything a uniform look


Window Theming

The window title bars are drawn onto your screen by the window manager you use. The default window manager of LXQt is Openbox.


To configure OpenBox, open the "LXQt Configuration Center" and select "Openbox Settings". Then select the same theme you choose in Kvantum.


GTK Theming

LXQt now provides an easy way to set the themes for GTK2 and GTK3 applications.


Open the "LXQt Configuration Center" and select "Appearance". On the "Widget Style" there are dropdowns to select the GTK styles.


Panel Theming

Panel theming is available via the LXQt Configuration Center --> LXQt Appearance --> LXQt Theme


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.


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 (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.

But if you want your custom icon in your panel, you must first create your own .desktop file (please keep reading).

Example:

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. It's file content is supposed to look like: 

[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 icon
  • Comment= gets shown when you hover with your mouse cursor over the icon
  • Exec= defines the terminal command, which is executed when the icon is clicked
  • Icon= specifies the path to the icon


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.


Create Custom Icon in Start Menu / Mainmenu

Read the previous chapter of this Wiki tutorial in order to get familiar with the content of .desktop files.

Now, a custom .desktop files needs to get created (as root) in this location: 

/usr/share/applications/

Please look at other .desktop files as examples for the .desktop file content: All have a category specified, e.g. 

Categories=Qt;KDE;Settings;

This setting is important for the Start Menu / Mainmenu category this custom icons appears in. Use it.

Another important line in the .desktop file is: 

OnlyShowIn=LXQt;

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.


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 with added icons.

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.

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 this tutorial to add your icon again.


Change Icon of Start Menu / Mainmenu

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


See Also

  • You can find more pages about LXQt in the Manjaro Wiki here.
Retrieved from "https://wiki.manjaro.org/index.php?title=LXQt&oldid=36008"