View source for LXQt

[[file:Lxqt_logo_and_name.svg | thumb | LXQt Logo]]

[[file:LXQt_Dark_1.2.0.png | thumb | LXQt 1.2.0 Dark Theme Official Screenshot]]

'''[https://lxqt-project.org/ LXQt]''' is a lightweight QT based desktop environment, LXQt was originally a port of LXDE to QT (called LXDE-Qt), it was created due to LXDE maintainer Hong Jen Yee being dissatisfied with GTK 3, on 21 July 2013 the LXDE(-Qt) and [https://en.wikipedia.org/wiki/Razor-qt Razor-qt] projects merged creating LXQt.

= Prerequisites =

* [[Installation|Install]] Alpine Linux
* [[Setting_up_a_new_user#Creating_a_new_user|Create a user account]] (optional but recommended)
* [[Repositories#Enabling_the_community_repository|Enable the Community repository]]
* [[Alpine_setup_scripts#setup-xorg-base|Install Xorg]]

= Basic LXQt Desktop Installation =

{{Note|Although LXQt is available in the stable branch, certain parts of this guide do require using the Edge (and Testing) branch(es).<br>
If you wish to use the latest version available, you will likely need to activate the Edge branch}}

{{Cmd|# apk add {{Pkg|lxqt-desktop}} {{Pkg|lximage-qt}} {{Pkg|obconf-qt}} {{Pkg|pavucontrol-qt}} {{Pkg|screengrab}} \
    {{Pkg|arandr}} \
    {{Pkg|dbus}} \
    {{Pkg|sddm}} \
    {{Pkg|sddm-openrc}}}}

{{Note|By default LXQt uses [[Openbox]] as its window manager (it is a dependency of the {{Pkg|lxqt-desktop}} package), but LXQt supports many different window managers, See: [https://github.com/lxqt/lxqt/wiki/ConfigWindowManagers Window Managers Configuration on the LXQt GitHub wiki]}}

Starting dbus (desktop bus) service:
{{Cmd|# rc-service dbus start}}

Enabling dbus to start on boot:
{{Cmd|# rc-update add dbus}}

If dbus is not running it leads to issues like missing icons and keyboard shortcuts.

Enabling udev service:
{{Cmd|# setup-devd udev}}

== Starting LXQt ==

=== With a display manager (DM) ===

If the package {{Pkg|sddm}} has been installed, SDDM may be started to log in graphically with your new user.
{{Cmd|# rc-service sddm start}}

After correct operation is verified, sddm can be enabled to start up during boot:
{{Cmd|# rc-update add sddm}}

=== From the command line ===

LXQt may be started with:
{{cmd|# startlxqt}}

== Localized keyboard layout ==

Preferences → LXQt Settings → Keyboard and Mouse → Keyboard Layout

== Allowing shut down and reboot ==

To enable users to shut down the machine or reboot, the packages {{Pkg|elogind}} and {{Pkg|polkit-elogind}} need to be installed.
{{Cmd|# apk add elogind polkit-elogind}}

A reboot is required to let it take effect.

== Auto-mounting USB drives ==

To enable automatic mounting of USB drives, install these packages:
{{Cmd|# apk add gvfs udisks2}}
 
Depending on what devices you intend to mount, some additional packages may be needed:
{{Cmd|ntfs-3g        Stable, full-featured, read-write NTFS (driver)
gvfs-cdda      CDDA support for gvfs
gvfs-afp       AFP support for gvfs
gvfs-goa       GNOME Online Accounts support for gvfs
gvfs-mtp       MTP support for gvfs
gvfs-smb       Windows fileshare support for gvfs
gvfs-lang      Languages for package gvfs
gvfs-afc       Apple mobile devices support for gvfs
gvfs-nfs       NFS support for gvfs
gvfs-dev       Backends for the gio framework in GLib (development files)
gvfs-archive   Archiving support for gvfs
gvfs-dav       WebDAV support for gvfs
gvfs-fuse      FUSE support for gvfs
gvfs-gphoto2   gphoto2 support for gvfs
gvfs-avahi     DNS-SD support for gvfs}}

To list descriptions of all gvfs- packages:
{{cmd|# apk info -d gvfs-*}}

== Network browsing ==

For browsing of network shares within LXQt that works with file associations, you can install the gvfs packages for the network protocols you use.

For example, to browse in a SMB/cifs windows network:
{{Cmd|# apk add gvfs-smb}}

(Check: If the above may already be sufficient for gvfs to initiate the fuse kernel module. Else, try to identify if there are necessary steps in:)

{{Cmd|# apk add gvfs-fuse}}

The OpenRC script for fuse is in a separate package.
{{Cmd|# apk add fuse-openrc}}

Then the fuse service can be started manually.
{{Cmd|# rc-service fuse start}}

If it works, the fuse service can be added to start up automatically at boot time:
{{Cmd|# rc-update add fuse}}

== Enabling privilege escalation GUI ==

To enable the privilege escalation GUI for a doas/sudo user, you need to install {{Pkg|elogind}}, {{Pkg|polkit-elogind}}, and {{Pkg|sddm}}.

To have elogind run, either make them start automatically at system start:

{{Cmd|# rc-update add elogind}}

or start them manually for this time only:

{{Cmd|# rc-service elogind start }}

== Panel Widgets ==

If you cannot add the CPU and System Statistics widgets to the panel, make sure {{Pkg|libstatgrab}} and {{Pkg|libsysstat}} are installed.

= Troubleshooting =

== Missing Icons and Fonts ==

By default a Desktop Environments needs icons. {{Pkg|adwaita-icon-theme}} is a good start.
{{Cmd|# apk add adwaita-icon-theme}}

See [[Fonts]] for more information on fonts.

= Optional packages =

== Screen Compositor ==

To enable different effects (transparency, for example) {{Pkg|picom}} can be used.

After installation, add it to the ''Autostart'' section of the '''LXQt Session Settings'''.

The default configuration is available in <code>/etc/xdg/picom.conf.example</code>. For modifications, it can be copied to <code>~/.config/picom/picom.conf</code> or <code>~/.config/picom.conf</code>.

Either modify the config file to your taste, or change the Autostart command line options. For example, <code>picom --vsync -r 12 --no-fading-openclose -b</code> overrides the <code>picom.conf</code> settings.

== Appearance Tweaking ==

Adding the KEY=VAL <code>QT_QPA_PLATFORMTHEME=lxqt</code> to the Environment section of the Session Settings [https://github.com/lxqt/lxqt-qtplugin#configuration-usage is suggested by the LXQt developers]. Then every Qt5 program can load the theme plugin.

Another option, however, is to to install the package {{Pkg|qt5ct}} (from [[Repositories | Testing]]) and appending the line <code>QT_QPA_PLATFORMTHEME=qt5ct</code> to the environmental settings in the Environment section of the Session Settings will allow you to achieve a unified appearance between apps. Then, in the LXQt Appearance Configuration, under Widget Style, set Qt Style to <code>qt5ct-style</code>.

== Documentation ==

* {{Pkg|lxqt-config-doc}} 
* {{Pkg|lxqt-openssh-askpass-doc}}
* {{Pkg|lxqt-panel-doc}} 
* {{Pkg|lxqt-policykit-doc}} 
* {{Pkg|lxqt-runner-doc}} 
* {{Pkg|lxqt-session-doc}}
* {{Pkg|lxqt-sudo-doc}}

== Development files ==

* {{Pkg|lxqt-globalkeys-dev}} 
* {{Pkg|lxqt-panel-dev}}

== Misc ==

* {{Pkg|lxqt-build-tools}}

= See Also =

* [[Installation#Post-Install|Post Install]]
* [[Desktop environments and Window managers]]

= External Resources =

* [https://lxqt.github.io/ LXQt Homepage]
* [https://github.com/lxqt/lxqt LXQt on GitHub]
* [https://wiki.archlinux.org/title/LXQt LXQt entry on ArchWiki]
* [https://github.com/sddm/sddm SDDM Project on GitHub]

[[Category:Desktop]]
[[Category:Desktop Environments]]