View source for LXQt

{{TOC right}}

[[File:LXQt Minimal Installation.png | thumb | LXQt 1.3.0 Basic Install with Papirus icons]]

'''[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 ==

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

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

{{:Include:Setup_Device_Manager}}

== 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 {{pkg|gvfs|arch=}} {{pkg|udisks2|arch=}}}}
 
Depending on what devices you intend to mount, some additional packages may be needed:
{{Cmd|{{pkg|ntfs-3g|arch=}}        Stable, full-featured, read-write NTFS (driver)
{{pkg|gvfs-cdda|arch=}}      CDDA support for gvfs
{{pkg|gvfs-afp|arch=}}       AFP support for gvfs
{{pkg|gvfs-goa|arch=}}       GNOME Online Accounts support for gvfs
{{pkg|gvfs-mtp|arch=}}       MTP support for gvfs
{{pkg|gvfs-smb|arch=}}       Windows fileshare support for gvfs
{{pkg|gvfs-lang|arch=}}      Languages for package gvfs
{{pkg|gvfs-afc|arch=}}       Apple mobile devices support for gvfs
{{pkg|gvfs-nfs|arch=}}       NFS support for gvfs
{{pkg|gvfs-dev|arch=}}       Backends for the gio framework in GLib (development files)
{{pkg|gvfs-archive|arch=}}   Archiving support for gvfs
{{pkg|gvfs-dav|arch=}}       WebDAV support for gvfs
{{pkg|gvfs-fuse|arch=}}      FUSE support for gvfs
{{pkg|gvfs-gphoto2|arch=}}   gphoto2 support for gvfs
{{pkg|gvfs-avahi|arch=}}     DNS-SD support for gvfs}}

To list descriptions of all gvfs- packages:

{{cmd|# apk info -d {{pkg|gvfs-*|arch=x86_64}}}}

== 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 Configuration ==

=== 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 {{Path|/etc/xdg/picom.conf.example}}. For modifications, it can be copied to {{Path|~/.config/picom/picom.conf}} or {{Path|~/.config/picom.conf}}.

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


=== Appearance Tweaking ===

==== Location of appearance-related configuration files ====

User-specific configuration is stored in {{Path|~/.config/lxqt/}}.

LXQt themes are [https://doc.qt.io/qt-6/stylesheet.html qss stylesheets]. They are located in {{Path|/usr/share/lxqt/themes/}} or {{Path|~/.local/share/lxqt/themes}}.

Qt Palette colors can be modified in lxqt-config-appearence > Widget Style > Qt Palette. Custom palettes are saved in {{Path|~/.local/share/lxqt/palettes/}}.


==== Additional QT Styles ====

Several packages provide additional QT Styles:

{{Cmd|# apk add {{Pkg|adwaita-qt}} {{Pkg|breeze}} {{Pkg|oxygen}}}}

They also provide additional cursors.


==== Consistant Theming ====

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


==== Additional Packages ====

When using themes found around the web, it is possible that they are dependant on different packages. Consider using {{Pkg|qt5-qtgraphicaleffects}}, {{Pkg|qt5-qtquickcontrols}}, and {{Pkg|qt5-qtquickcontrols2}}.

== 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]]