LXQt

2023-08-31T20:23:34Z

Oparniere: add xf86-input-libinput for sddm (otherwise no input from mouse and keyboard)

{{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|dbus}} \
{{Pkg|sddm}} \
{{Pkg|sddm-openrc}} \
{{Pkg|xf86-input-libinput}}}}

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

=== Appearance Tweaking ===

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

User-specific configuration is stored in <code>~/.config/lxqt/</code>.

LXQt themes are [https://doc.qt.io/qt-6/stylesheet.html qss stylesheets]. They are located in <code>/usr/share/lxqt/themes/</code> or <code>~/.local/share/lxqt/themes</code>.

Qt Palette colors can be modified in lxqt-config-appearence > Widget Style > Qt Palette. Custom palettes are saved in <code>~/.local/share/lxqt/palettes/</code>.

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

Alpine Linux - User contributions [en]

LXQt