Minimal LXQt installation

From Manjaro Linux
Jump to: navigation, search

This tutorial is about installing LXQt on top of Manjaro Net Edition using primarily the Qt5 and GTK2 toolkits. Furthermore, Openbox is used as window manager.

On first sight, this tutorial might look intimidating because of its length and wealth of information. But installing LXQt can be as simple as installing 4 packages (and a login manager) as this Wiki section shows. All other content in this tutorial is made up of explanations, alternative installation methods, fixes for potential bugs, and a lot of recommended tools to expand LXQt into a modern and comfortable operating system.


Manjaro Net Edition

Please download the latest Manjaro Net Edition (with LXQt desktop) from here and burn it. It boots to a live system running the LXQt desktop environment. Start the graphical installer by double clicking the desktop icon. Follow the instructions and do not change the default package selection. This will install a basic command line edition of Manjaro by downloading all the chosen packages from the internet and installing them to your system.

When the graphical installer is done, reboot your system and start your freshly installed Net Edition. Log in using your user name and password

Instead of following this guide, you can also choose the packages you want to install within the package selection category of the Manjaro Net Edition GUI installer. This is usually quicker than installing everything manually. But it is still a good advice to read through this guide at least once in order to get an idea, which packages you actually want to install.

Internet Connection

If you have trouble connecting to the Internet, e.g. on a wireless network, please try to choose your wifi card and try to connect using one of the following terminal programs:


If you still have trouble, it is recommended to reinstall the Manjaro Net Edition and ticking all network related packages in the package selection category before installation.

Minimal System Installation


There are three different methods of installing LXQt on your system. Please choose one of them:

Simple Installation:

Execute the following command:

sudo pacman -S lxqt

Minimal Installation:

LXQt is made up of multiple packages. Install the most important packages first:

sudo pacman -S lxqt-config lxqt-panel lxqt-policykit lxqt-qtplugin lxqt-session lxqt-sudo pcmanfm-qt

The following LXQt packages are not as important, install them when necessary. If you you have doubts about the necessity of a package, install it:

sudo pacman -S lxqt-about lxqt-admin lxqt-globalkeys lxqt-notificationd lxqt-openssh-askpass lxqt-powermanagement lxqt-runner
  • lxqt-about offers you the "About LXQt" window.
  • lxqt-admin offers additional settings, i.e. "Date and Time" and "Users and Groups". manjaro-settings-manager offers the same settings and many more.
  • lxqt-globalkeys offers gloabal keyboard shortcut settings
  • lxqt-notificationd offers notification support for LXQt and other applications
  • lxqt-openssh-askpass enables the openSSH Askpass module. If you do not know what this is, you probably do not need it.
  • lxqt-powermanagement offers power management settings. This is useful for laptops.
  • lxqt-runner is a simple quick launch application with search support similar to synapse or gnome-do

Installation from the AUR:

If you want to install the latest development versions of LXQt packages, you need to install yaourt first. Then download and compile directly from the LXQt git repositories as explained in the LXQt Wiki:

yaourt -S lxqt-dektop-git pcmanfm-qt-git
note: This command is likely to require your attention during the build process. When the build process fails, read the comments in the AUR, edit the PKGBUILD file, or file a detailed bug report.

Essential Packages

After the successful installation of LXQt, some essential non-LXQt packages are required:

sudo pacman -S openbox qterminal breeze-icons
  • openbox is a leight-weight window manager. This is the recommended window manager for LXQt. Nevertheless, it is possible to install LXQt with kwin.
  • qterminal is a terminal with drop-down functionality supported by the LXQt developers. If you want a leight-weight (GTK2 based) terminal, please install lxterminal instead.
  • breeze-icons is the recommended icon set of LXQt. Feel free to install any other icon set you like, but be prepared to see a couple of placeholder icons (or no icons at all) in the LXQt Configuration Center.

Graphics Driver

Some Manjaro disk images do not include graphics drivers. Please check, if there is a graphics driver installed on your system:

mhwd -li

If you see at least one graphics driver name in the list, you can skip the rest of this chapter and continue with the chapter Login Manager.

If you see an empty list, there is no graphics driver installed on your system.

You can check which graphics drivers are available for your system with


Choose one graphics driver and keep it's name (e.g. video-nouveau) in your mind.

Use the name in the following installation command for graphics drivers:

sudo mhwd -i pci <Graphics Driver Name>

Example for installing the open-source Nouveau graphics driver for Nvidia graphics cards:

sudo mhwd -i pci video-nouveau

If you encounter any error or need further information about graphics drivers in Manjaro, click Configure Graphics Cards.

Login Manager

The recommended login manager for LXQt is sddm:

sudo pacman -S sddm

Advanced users can even Auto-Login without a Graphical Desktop Manager & with Systemd.

Next, you need to enable sddm:

sudo systemctl enable sddm


Reboot your system using:


You can now log in using sddm as graphical login manager. Please make sure LXQt-Desktop is the selected session.

After logging into LXQt, in case you do not see a wallpaper and parts of the panel are invisible (this can happen in VirtualBox setups), please open the Start Menu in the bottom left corner of your screen by clicking on it and choosing manually another Design: Start Menu --> Settings --> LXQt Settings --> LXQt Appearance Settings --> LXQt-Design.

Start a terminal (lxterminal or qterminal) from your Start Menu and continue with this tutorial.

All the following packages are not mandatory anymore, but installing (most of) them will result in a fairly user-friendly system with most of the functionality expected by users of a modern operating system. Please read at least the short description of every package and decide for yourself whether you want to install it.

Basic Packages

Unfortunately, there is no single setting window in LXQt capable of changing all available settings. Therefore, multiple setting managers are necessary:

sudo pacman -S manjaro-settings-manager gvfs gvfs-afc gksu octopi octopi-notifier-qt5 qt5-translations obconf-qt
yaourt -S featherpad
  • manjaro-settings-manager offers all manjaro-specific settings.
  • gvfs lets you mount other file systems (e.g. other hard drives in your computer) Attention: GTK3 based; How to remove GTK3.
  • gvfs-afc enables support for removable media (e.g. USB sticks) Attention: GTK3 based; How to remove GTK3.
  • gksu is a graphical frontend for the "su" command (GTK2 based)
  • octopi is Manjaro's graphical package manager based on Qt5
  • octopi-notifier-qt5 is a status icon for octopi, which informs about available updates
  • qt5-translations is needed for translations to work properly. Only needed for non-English LXQt setups!
  • obconf-qt is the Openbox Configuration Center and contains all window manager specific settings. It integrates nicely into the LXQt Configuration Center.
  • featherpad is a light-weight plain text editor.


In the following chapters, some packages need to be downloaded and compiled from the AUR. yaourt is recommended for this, but you can also use pacaur instead. In any case, base-devel package is also needed for AUR support.

There are two different methods of installing yaourt on your system. Please choose one of them:

Simple Installation:

Install these packages for a complete, but relatively heavy-weight download:

sudo pacman -S base-devel yaourt

In order to decrease the download size, only download and install the necessary packages with

sudo pacman -S base-devel yaourt --needed

Minimal Installation:

For average usage of the AUR, it is not necessary to install all base-devel packages. Please install all base-devel packages, if you encounter extraordinary errors during the build process of AUR packages. base-devel is a prerequisite for a lot of AUR packages.

Use this command for a light-weight download:

sudo pacman -S autoconf automake binutils fakeroot libconfig libtool m4 make patch subversion git yaourt

Also do this for 32bit systems:

sudo pacman -S gcc

And this for 64bit systems:

sudo pacman -S gcc-multilib

note: If you trust the PKGBUILD creators or want a "quick and dirty" installation, use the --noconfirm flag on all yaourt commands.

More Packages

sudo pacman -S octopi-repoeditor octopi-cachecleaner gvfs-smb lxtask
yaourt -S xarchiver-gtk2
  • octopi-repoeditor is a repository extension for octopi.
  • octopi-cachecleaner is a front end for paccache for octopi. This lets you clean your unused and/or old package files.
  • gvfs-smb offers Samba support. Attention: GTK3 based; How to remove GTK3.
  • lxtask is a light-weight task manager (GTK2 based).
  • xarchiver-gtk2 is a GUI for command line archiving tools. You need to enable it in pcmanfm-qt (your file manager) preferences/settings to use it as default. If you need .7z archive support, please install p7zip,too.

Connection Manager

If you want a Qt based network/connection manager with a configuration GUI, please install connman as described below. If you like the default NetworkManager, please keep on reading the next chapter of this tutorial.

sudo pacman -S connman cmst

Next, please stop the pre-installed NetworkManager service:

sudo systemctl stop NetworkManager

You need to enable the connection manager service before cmst can be used:

sudo systemctl start connman
sudo systemctl enable connman

You can start the connection manager applet via Main/Start Menu --> Settings --> LXQt Settings --> Network Management.

Make sure you have access to the Internet again. If successful, you can safely remove the pre-installed GTK2 based networkmanager:

sudo pacman -Rc networkmanager

Even more Packages

sudo pacman -S qpdfview speedcrunch xscreensaver gvfs-mtp gvfs-gphoto2 libdvdcss lxappearance
yaourt -S lximage-qt qisousb
  • qpdfview is a Qt5 based pdf viewer
  • speedcrunch is a Qt4 calculator. There is a Qt5 port available in the AUR: speedcrunch-git
  • xscreensaver offers some simple screen savers. By default, LXQt switches your screen off after a short period of inactivity. This can happen when you watch a movie, too. xscreensaver offers setting options for changing this default behavior or LXQt. It also enables screen locking.
  • gvfs-mtp enables mfs support on your system. This is needed for a successful recognition of certain cameras, cell phones, media players, tablets, etc. e.g. in your file manager. Attention: GTK3 based; How to remove GTK3.
  • gvfs-gphoto2 offers additional support for some media players and digital cameras. Attention: GTK3 based; How to remove GTK3.
  • libdvdcss provides libraries to decode encrypted DVDs. Install this package when you have trouble playing DVDs on your system.
  • lxappearance is a theme switcher developed for LXDE. If you feel you lack a settings manager for GTK2 themes, install this.
  • lximage-qt is a light-weight image viewer and screenshot tool made by LXQt developers. This package is dependent on pcmanfm-qt.
  • qisousb can write image files (e.g. ".iso" files) to USB sticks and make them bootable. Instead of qisousb, you can also use imagewriter instead.

Internet Browser

There are a lot internet browsers available. Please choose one of the following:

Simple Installation:

For Mozilla Firefox with Flash support (install only when needed), install these packages:

sudo pacman -S firefox flashplugin

For Chromium with Flash support (install only when needed), please install these packages:

sudo pacman -S chromium
yaourt -S chromium-pepper-flash

Minimal Installation:

Please choose one of the two following lightweight, user-friendly, and modern Qt5 browsers without Flash, but the ability to play HTML5.

sudo pacman -S qupzilla gst-libav gst-plugins-good

sudo pacman -S gst-libav gst-plugins-good
yaourt -S otter-browser

Media Player

A light-weight media player:

sudo pacman -S mpv

If you want to change settings and/or keyboard shortcuts of mpv, please follow the instructions here.

Alternatively, a well-known media player with a larger footprint can be installed:

sudo pacman -S vlc

Audio Player

There is a light-weight audio player available:

sudo pacman -S qmmp

Alternatively, an audio player with many more features can be installed:

sudo pacman -S cantata


Pulseaudio is a modern sound server, which is particularly useful setups with multiple speakers and/or microphones and can be installed with the following command:

Simple Installation:

sudo pacman -S manjaro-pulse pavucontrol

Minimal Installation:

sudo pacman -S pulseaudio
yaourt -S pavucontrol-qt-git

pavucontrol offers a GUI for easy Pulseaudio configuration.

Printer Support

There are two different methods of installing a printer on your system. Please choose one of them:

Simple Installation:

Just execute the command (Attention: GTK3 based):

sudo pacman -S manjaro-printer

In case you have questions, there is a separate wiki page dedicated to Printing Enablement.

Minimal Installation:

First install CUPS on your system:

sudo pacman -S cups

Next, connect your printer to your PC and choose Start Menu --> System Tools --> Manage Printing. CUPS will open an interface in your Browser. Add your printer. When asked for a username and password, enter root and your password.

If CUPS cannot add your printer, it lacks a driver for it. In this case, install one of the following packages at a time and try to add your printer to CUPS again until you find the package containing the right driver for your printer.

Use sudo pacman -S for installation:

  • gutenprint - A collection of high quality drivers for Canon, Epson, Lexmark, Sony, Olympus, and PCL printers.
  • hplip - HP drivers for DeskJet, OfficeJet, Photosmart, Business Inkjet and some LaserJet printer models, as well as a number of Brother printers.
  • splix - Samsung drivers for SPL (Samsung Printer Language) printers.
  • foomatic-db-nonfree - Install this, when the other packages do not work for you.

If neither of the above packages works for your printer, read more about CUPS in the Arch Wiki.

Activating Num Lock

Version 0.10 of LXQt offers an easy check box setting for activating Num Lock: Main Menu --> Settings --> LXQt Session Configuration --> Keyboard and Mouse --> Keyboard.

If this does not work, or your version of LXQt is older, please install numlockx:

sudo pacman -S numlockx

Now, you can use to following commands in your terminal to switch Num lock on or off:

numlockx on
numlockx off

If you want Num Lock always activated, you need to open the Main Menu --> Settings --> LXQt Session Configuration --> Autostart. There, please create a new Autostart element with any name and the numlockx on command.

Finding more Qt Programs

There is an extensive List of Qt Applications available.


You can find more wiki pages about LXQt (e.g. theming tips, etc.) here.

A forum subsection dedicated to LXQt and LXDE can be found here. Tell us about your LXQt experience and favorite Qt programs!