Difference between revisions of "LXQt"

From ArchWiki
Jump to navigation Jump to search
(Remove stub flag.)
(Added Xinitrc file path. If you look at other desktop enviroment pages Xinitrc is always given as file path. This page was exception)
 
(53 intermediate revisions by 29 users not shown)
Line 1: Line 1:
 
[[Category:Desktop environments]]
 
[[Category:Desktop environments]]
 
[[ja:LXQt]]
 
[[ja:LXQt]]
[[ru:Razor-qt]]
+
[[ru:LXQt]]
[[zh-CN:LXQt]]
+
[[zh-hans:LXQt]]
 
{{Related articles start}}
 
{{Related articles start}}
 
{{Related|LXDE}}
 
{{Related|LXDE}}
Line 10: Line 10:
 
In early 2013, Hong Jen Yee "PCMan" started porting [[LXDE]] components to [[Qt]]. The first [http://blog.lxde.org/?p=1013 preview of LXDE-Qt] was released on July 3rd, 2013. On July 21st, it was announced that Razor-qt (a desktop similar in design to LXDE) and LXDE were merging.  
 
In early 2013, Hong Jen Yee "PCMan" started porting [[LXDE]] components to [[Qt]]. The first [http://blog.lxde.org/?p=1013 preview of LXDE-Qt] was released on July 3rd, 2013. On July 21st, it was announced that Razor-qt (a desktop similar in design to LXDE) and LXDE were merging.  
  
The result is [http://lxqt.org LXQt], a desktop built on Qt which partly uses Razor-qt and LXDE components. While development is mainly focused on LXQt, the GTK+ 2 version of LXDE will see continued development.
+
The result is [http://lxqt.org LXQt], a desktop built on Qt which partly uses Razor-qt and LXDE components. While development is mainly focused on LXQt, the GTK 2 version of LXDE will see continued development.
  
 
== Installation ==
 
== Installation ==
  
[[Install]] the {{Grp|lxqt}} group.
+
[[Install]] the {{Grp|lxqt}} group and an icon theme (e.g. {{Pkg|breeze-icons}} or {{Pkg|oxygen-icons}}).
  
You also need an icon theme to be installed. The default one is ''Oxygen'', which can be installed with the {{Pkg|oxygen-icons}} package.
+
For additional functionality, you may wish to install the following:
 +
 
 +
* {{App|LXQt Connman applet|LXQt system-tray applet for [[ConnMan]].|https://github.com/lxqt/lxqt-connman-applet|{{AUR|lxqt-connman-applet}}}}
 +
* {{App|[[SDDM]]|The recommended display manager for LXQt.|https://github.com/sddm/sddm|{{Pkg|sddm}}}}
 +
* A screen locker, if needed. For example, [[slock]] or [[XScreenSaver]]. Both are confirmed to integrate with LXQt, others may too. If you want to disable screen locking upon suspend/sleep it is under ''LXQt > Preferences > LXQt Settings > Session Settings > Lock screen before suspending/hibernating'' checkbox.
 +
* If you haven't yet, install xorg.
  
For additional functionality, you may wish to install the following:
+
{{Tip|LXQt uses ''xdg-screensaver'' from {{Pkg|xdg-utils}} for screen locking which only works with XScreenSaver and {{Pkg|xautolock}} in LXQt session. You can use it or another screen locker by itself. For example, with ''slock'' you can follow [[Slock#Lock on suspend]] as well as install patched {{AUR|xdg-utils-slock}} to obtain feelings expected by LXQt
 +
}}
  
* {{App|LXImage-Qt|Image viewer and screenshot tool for LXQt.| https://github.com/lxde/lximage-qt | {{AUR|lximage-qt}}}}
+
* Some LXQt panel plugins require extra packages to function, check the [[PKGBUILD#optdepends|optional dependencies]] for {{Pkg|lxqt-panel}}.
* {{App|ObConf-Qt| The Qt port of ObConf, the [[Openbox]] configuration tool. | https://github.com/lxde/obconf-qt | {{AUR|obconf-qt}}}}
 
* {{App|QTerminal|Lightweight Qt-based terminal emulator.| https://github.com/qterminal/qterminal | {{AUR|qterminal}}}}
 
* {{App|[[SDDM]]|The recommended display manager for LXQt.| https://github.com/sddm/sddm | {{Pkg|sddm}}}}
 
  
 
== Starting the desktop ==
 
== Starting the desktop ==
Line 31: Line 34:
 
Append the following line to [[Xinitrc]]:
 
Append the following line to [[Xinitrc]]:
  
exec startlxqt
+
{{hc|~/.xinitrc|exec startlxqt}}
  
 
=== Graphical login ===
 
=== Graphical login ===
Line 41: Line 44:
 
LXQt in general tries to provide GUI applications to change its settings. Configuration files are in {{ic|~/.config/lxqt}}. This directory is initialized automatically. The default configuration for new users is found in {{ic|/etc/xdg/lxqt}}.
 
LXQt in general tries to provide GUI applications to change its settings. Configuration files are in {{ic|~/.config/lxqt}}. This directory is initialized automatically. The default configuration for new users is found in {{ic|/etc/xdg/lxqt}}.
  
=== Replace Openbox ===
+
=== Use a different window manager ===
  
While [[Openbox]] is the default [[window manager]] for LXQt, you can specify a different window manager to use with LXQt via the ''Session Settings'', or by editing {{ic|~/.config/lxqt/session.conf}}. Change the following line:
+
While [[Openbox]] is the default [[window manager]] for LXQt, you can specify a different window manager to use with LXQt via ''Session Settings'', {{ic|lxqt-config-session}}; or by editing {{ic|~/.config/lxqt/session.conf}}. Change the following line:
  
 
  window_manager=openbox
 
  window_manager=openbox
Line 51: Line 54:
 
  window_manager=''your_window_manager''
 
  window_manager=''your_window_manager''
  
=== Autostarting applications ===
+
=== Autostart ===
 +
 
 +
To have X applications start on login, click the main menu from the ''LXQt > Preferences > LXQt Settings > Session Settings''. Alternatively, this can be launched with:
  
To have X applications start on login, click the main menu from the LXQt -> Preferences -> LXQt Settings -> Session Settings. Alternatively, this can be launched with:
 
 
  lxqt-config-session
 
  lxqt-config-session
From this window, click on "AutoStart" on the left side. Here you can add a new application to either the global autostart (launched in all sessions implementing the said specification) or your local autostart (labled LXQt Autostart) (See [https://github.com/lxde/lxqt/issues/746 issue 746] for a bug related to this option).
+
 
 +
From this window, click on ''AutoStart'' on the left side. Here you can add a new application to either the global autostart (launched in all sessions implementing the [[XDG Autostart]] specification) or your local autostart (labelled LXQt Autostart) (See [https://github.com/lxde/lxqt/issues/746 issue 746] for a bug related to this option). For each item you add, {{ic|lxqt-config-session}} will create a Desktop entry (''.desktop'' file) in the appropriate [[XDG Autostart]] directory.
 +
 
 +
The distinction between "Global Autostart" and "LXQt Autostart" does not depend on the directory in which the corresponding ''.desktop'' file is located, but rather on the {{ic|OnlyShowIn}} setting. If it is {{ic|1=OnlyShowIn=true}}, it is considered an "LXQt Autostart". Furthermore, if {{ic|1=X-LXQt-Module=true}}, the item is not shown in {{ic|lxqt-config-session}}.
 +
 
 +
=== Set-up environment variables ===
 +
 
 +
[[Environment variables]] for LXQt session can be defined in Session Settings.
  
 
=== Editing the Application Menu ===
 
=== Editing the Application Menu ===
  
It is possible to edit menu entries by editing their .desktop files stored in {{ic|/usr/share/applications/lxqt-*.desktop}} files. See [[Desktop entries]].
+
It is possible to edit menu entries by editing their ''.desktop'' files stored in {{ic|/usr/share/applications/lxqt-*.desktop}} files. See [[Desktop entries]].
 +
 
 +
== Troubleshooting ==
 +
 
 +
=== Desktop icons are grouped together ===
 +
 
 +
When moving icons on the desktop it is possible to place them a bit too close to each other making them connected. If unable to separate them Stop Desktop from Session Settings, remove {{ic|~/.config/pcmanfm-qt/lxqt/desktop-items-0.conf}} and Start Desktop again.
 +
 
 +
== Tips and tricks ==
 +
 
 +
=== Customizing Leave ===
 +
 
 +
One can customize the options available under ''Leave'' simply by copying the respective package provide {{ic|.desktop}} file to {{ic|~/.local/share/applications}} and modifying it to contain the {{ic|1=NoDisplay=true}} directive.  Reference: [https://github.com/lxde/lxqt/issues/876 #876].
 +
 
 +
Complete list of files to consider masking include:
 +
 
 +
lxqt-hibernate.desktop
 +
lxqt-leave.desktop
 +
lxqt-lockscreen.desktop
 +
lxqt-logout.desktop
 +
lxqt-reboot.desktop
 +
lxqt-shutdown.desktop
 +
lxqt-suspend.desktop
  
== Suggested applications ==
+
Example: remove hibernate option.
  
As LXQt is a lightweight desktop, a plain install will not provide many desktop applications. It is left to the user to choose what applications they wish to install. The [https://github.com/Razor-qt/razor-qt/wiki/3rd-party-applications Razor-qt wiki] has a page which lists of number of useful Qt applications that you may wish to install. Also see the [[List of applications]] page for a comprehensive list of applications available in Arch.
+
$ mkdir -p ~/.local/share/applications
 +
$ sed '/OnlyShowIn/aNoDisplay=true' </usr/share/applications/lxqt-hibernate.desktop >~/.local/share/applications/lxqt-hibernate.desktop
  
 
== See also ==
 
== See also ==
Line 70: Line 104:
 
* [https://github.com/lxde/lxqt LXQt development]
 
* [https://github.com/lxde/lxqt LXQt development]
 
* [http://lxqt-de.deviantart.com/ LXQt on deviantART]
 
* [http://lxqt-de.deviantart.com/ LXQt on deviantART]
* [https://github.com/lxde/lxqt/wiki LXQt wiki on GitHUb]
+
* [https://github.com/lxde/lxqt/wiki LXQt wiki on GitHub]

Latest revision as of 11:28, 17 January 2020

In early 2013, Hong Jen Yee "PCMan" started porting LXDE components to Qt. The first preview of LXDE-Qt was released on July 3rd, 2013. On July 21st, it was announced that Razor-qt (a desktop similar in design to LXDE) and LXDE were merging.

The result is LXQt, a desktop built on Qt which partly uses Razor-qt and LXDE components. While development is mainly focused on LXQt, the GTK 2 version of LXDE will see continued development.

Installation

Install the lxqt group and an icon theme (e.g. breeze-icons or oxygen-icons).

For additional functionality, you may wish to install the following:

  • LXQt Connman applet — LXQt system-tray applet for ConnMan.
https://github.com/lxqt/lxqt-connman-applet || lxqt-connman-appletAUR
  • SDDM — The recommended display manager for LXQt.
https://github.com/sddm/sddm || sddm
  • A screen locker, if needed. For example, slock or XScreenSaver. Both are confirmed to integrate with LXQt, others may too. If you want to disable screen locking upon suspend/sleep it is under LXQt > Preferences > LXQt Settings > Session Settings > Lock screen before suspending/hibernating checkbox.
  • If you haven't yet, install xorg.
Tip: LXQt uses xdg-screensaver from xdg-utils for screen locking which only works with XScreenSaver and xautolock in LXQt session. You can use it or another screen locker by itself. For example, with slock you can follow Slock#Lock on suspend as well as install patched xdg-utils-slockAUR to obtain feelings expected by LXQt

Starting the desktop

Using xinit

Append the following line to Xinitrc:

~/.xinitrc
exec startlxqt

Graphical login

Choose LXQt Desktop from the menu in a display manager of choice.

Configuration

LXQt in general tries to provide GUI applications to change its settings. Configuration files are in ~/.config/lxqt. This directory is initialized automatically. The default configuration for new users is found in /etc/xdg/lxqt.

Use a different window manager

While Openbox is the default window manager for LXQt, you can specify a different window manager to use with LXQt via Session Settings, lxqt-config-session; or by editing ~/.config/lxqt/session.conf. Change the following line:

window_manager=openbox

to a window manager of choice:

window_manager=your_window_manager

Autostart

To have X applications start on login, click the main menu from the LXQt > Preferences > LXQt Settings > Session Settings. Alternatively, this can be launched with:

lxqt-config-session

From this window, click on AutoStart on the left side. Here you can add a new application to either the global autostart (launched in all sessions implementing the XDG Autostart specification) or your local autostart (labelled LXQt Autostart) (See issue 746 for a bug related to this option). For each item you add, lxqt-config-session will create a Desktop entry (.desktop file) in the appropriate XDG Autostart directory.

The distinction between "Global Autostart" and "LXQt Autostart" does not depend on the directory in which the corresponding .desktop file is located, but rather on the OnlyShowIn setting. If it is OnlyShowIn=true, it is considered an "LXQt Autostart". Furthermore, if X-LXQt-Module=true, the item is not shown in lxqt-config-session.

Set-up environment variables

Environment variables for LXQt session can be defined in Session Settings.

Editing the Application Menu

It is possible to edit menu entries by editing their .desktop files stored in /usr/share/applications/lxqt-*.desktop files. See Desktop entries.

Troubleshooting

Desktop icons are grouped together

When moving icons on the desktop it is possible to place them a bit too close to each other making them connected. If unable to separate them Stop Desktop from Session Settings, remove ~/.config/pcmanfm-qt/lxqt/desktop-items-0.conf and Start Desktop again.

Tips and tricks

Customizing Leave

One can customize the options available under Leave simply by copying the respective package provide .desktop file to ~/.local/share/applications and modifying it to contain the NoDisplay=true directive. Reference: #876.

Complete list of files to consider masking include:

lxqt-hibernate.desktop
lxqt-leave.desktop
lxqt-lockscreen.desktop
lxqt-logout.desktop
lxqt-reboot.desktop
lxqt-shutdown.desktop
lxqt-suspend.desktop

Example: remove hibernate option.

$ mkdir -p ~/.local/share/applications
$ sed '/OnlyShowIn/aNoDisplay=true' </usr/share/applications/lxqt-hibernate.desktop >~/.local/share/applications/lxqt-hibernate.desktop

See also