From ArchWiki
(Redirected from Lxqt)
Jump to: navigation, search

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.


Install the lxqt group.

An icon theme is also needed. The default one is Oxygen, which can be installed with the oxygen-icons package.

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

http://git.kernel.org/cgit/network/connman || connman
  • LXQt Connman applet — LXQt system-tray applet for Connman.
https://github.com/surlykke/lxqt-connman-applet || lxqt-connman-applet-gitAUR
  • LXImage-Qt — Image viewer and screenshot tool for LXQt.
https://github.com/lxde/lximage-qt || lximage-qtAUR
  • ObConf-Qt — The Qt port of ObConf, the Openbox configuration tool.
https://github.com/lxde/obconf-qt || obconf-qtAUR
  • LXAppearance — Easy to use GTK+ configuration tool. Part of LXDE.
git://lxde.git.sourceforge.net/gitroot/lxde/lxappearance || lxappearance
  • QTerminal — Lightweight Qt-based terminal emulator.
https://github.com/qterminal/qterminal || qterminalAUR
  • SDDM — The recommended display manager for LXQt.
https://github.com/sddm/sddm || sddm
https://www.jwz.org/xscreensaver/ || xscreensaver

Some LXQt panel plugins require extra packages to function, check the optional dependencies for lxqt-panel.

Starting the desktop

Using xinit

Append the following line to Xinitrc:

exec startlxqt

Graphical login

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


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.

Replace Openbox

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:


to a window manager of choice:


Autostarting applications

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:


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 issue 746 for a bug related to this option).

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.


If present Compton should auto start with the initial default session.

Suggested applications

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


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.

See also