LXQt - ArchWiki

# LXQt

Related articles

- LXDE
- Desktop environment
- Window manager

This article is a stub.

Notes: Little more than a list of applications (Discuss)

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. The final release of Razor-qt is 0.6.0.

## Installation

Install the lxqt group which is available in the official repositories. Also install openbox - the default window manager for LXQt.

You may also wish to install the following:

- qterminal-git - lightweight Qt terminal emulator.
- obconf-qt-git - provides the Qt port of the openbox configuration tool ObConf.
- oxygen-icons - provides a compatible icon theme for the LXQt desktop.
- qtcurve - provides a compatible Qt theme for the LXQt desktop.
- sddm - the recommended LXQt display manager

### Graphical login

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

### Using xinit

Append the following line to Xinitrc:

    exec startlxqt

## Configuration

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 the default window manager

While Openbox is the default window manager for LXQt, you can specify a different window manager to use with LXQt via the Session Settings, or by editing `~/.config/lxqt/session.conf`. Change the following line:

    window_manager=openbox

to a window manager of choice:

    window_manager=your_window_manager

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

## Troubleshooting

This article or section is a candidate for merging with Qt.

Notes: Not related to only LXQT (Discuss)

### Qt themes not respected

If LXQt's applications do not stick with your Qt-theme (especially when using KDE's system settings to set your theme), then as of KDE 4.6.1 you'll probably need to tell Qt how to find KDE's styles (Oxygen, QtCurve etc.)

You just need to set the environment variable QT_PLUGIN_PATH. E.g. put

    export QT_PLUGIN_PATH=$HOME/.kde4/lib/kde4/plugins/:/usr/lib/kde4/plugins/

into your `/etc/profile` (or `~/.profile` if you do not have root access). `qtconfig-qt4` should then be able to find your kde styles and everything should look nice again!

Alternatively, you can symlink the Qt styles directory to the KDE styles one:

    # ln -s /usr/lib/kde4/plugins/styles/ /usr/lib/qt/plugins/styles

### Qt Configuration fails to start

'Qt Configuration', in the LXQt Configuration Center and in the Preferences menu, is used to start `qtconfig`. The following environmental variables are needed before qtconfig will run:

    export QTCHOOSER_RUNTOOL=qtconfig
    export QT_SELECT=4

The above will enable qtconfig for qt4.

## See also

- LXQt homepage
- LXQt development
- LXQt on deviantART

Category:

- Desktop environments