LXQt - Debian Wiki

LXQt Logo (CC BY-SA 3.0)

LXQt, the lightweight Qt desktop environment, is designed to be especially energy-efficient and suitable for older systems. It is based on the widget toolkit Qt and uses SDDM as its recommended/standard display manager and xfwm4 as its default window manager.

LXQt is available in Debian stable since Stretch (Debian 9). For developers, please see Teams/lxqt-team for more information.

Contents

Installation
Starting the desktop
Configuration
Links

Installation

Live install images

Live install images with LXQt are available.

Debian Installer

LXQt is available as a choice for DebianInstaller.

Package Manager

LXQt can be installed manually using PackageManagement tools, such as apt.

The lxqt-core metapackage provides only the core LXQt components.
- ```
  # apt install lxqt-core
```
The lxqt metapackage provides the LXQt components and some other recommended packages.
- ```
  # apt install lxqt
```
The task-lxqt-desktop package installs the full Debian desktop with LXQt.
- ```
  # apt install task-lxqt-desktop
```

Starting the desktop

Using a display manager

If you are using a graphical DisplayManager, LXQt should be available as an option.

From the console

LXQt can be started from the console by running startlxqt.

startlxqt is a script that sets the required environment variables and calls Xinit to start the X server with the LXQt session.

Using Xinit

Modern desktop environments have session management tools, it should not be necessary to edit the ~/.xinitrc file to include the following line:

exec startlxqt

See Xinitrc for more information.

Configuration

Configuration Center

LXQt has a graphical configuration center with links to all of the available settings (brightness, sound, session, etc.). It can be accessed from the panel menu under Preferences > LXQt Settings > LXQt Configuration Center.

Alternatively, the configuration center can be launched from the command line using the lxqt-config command. Other settings can also be launched using the following commands:

lxqt-config-appearance: launches the appearance settings
lxqt-config-brightness: launches brightness settings
lxqt-config-file-associations: launches file associations settings
lxqt-config-globalkeyshortcuts: launches keyboard shortcut settings
lxqt-config-input: launches keyboard and mouse settings
lxqt-config-locale: launches locale settings
lxqt-config-monitor: launches monitor settings
lxqt-config-notificationd: launches desktop notification settings
lxqt-config-powermanagement: launches power management settings
lxqt-config-session: launches session settings

Configuration Files

Global configuration files are stored in /etc/xdg/lxqt/. User-specific configuration is stored in ~/.config/lxqt/, the ini format is used.

Optional Appearance Configuration

LXQt developers recommend setting QT_QPA_PLATFORMTHEME=lxqt in in the Environment section of the Session Settings in order for all Qt-based programs can adopt settings of LXQt, such as the icon theme.

Themes

LXQt themes are qss stylesheets. They are located in /usr/share/lxqt/themes/ or ~/.local/share/lxqt/themes.

Palettes

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

Example Palette
- ```
   1   [Palette]
   2   base_color=#2e3440
   3   highlight_color=#5e81ac
   4   highlighted_text_color=#eceff4
   5   link_color=#88c0d0
   6   link_visited_color=#b48ead
   7   text_color=#eceff4
   8   window_color=#3b4252
   9   window_text_color=#eceff4
```

QTerminal Color Schemes

It is possible to add additional color schemes to QTerminal by adding a .colorscheme file to /usr/share/qtermwidget5/color-schemes.

QTerminal uses the same color scheme formatting as KDE's Konsole. Example color schemes can be seen here.

Qt5 Configuration Utility

This utility allows users to configure Qt5 settings (theme, font, icons, etc.) under DE/WM without Qt integration.

Install the qt5ct package and append the line QT_QPA_PLATFORMTHEME=qt5ct to the environmental settings in the Environment section of the Session Settings. Then, in the LXQt Appearance Configuration, under Widget Style, set Qt Style to qt5ct-style.

Links

CategoryDesktopEnvironment