From Gentoo Wiki
< LXDE(Redirected from Project:LXDE/HOWTO)
Jump to: navigation, search

This guide introduces the user to LXDE, explains its components, and leads the user through the installation.


What is LXDE?

After installing your base Gentoo system, and the X Server, you have to make many choices regarding your graphical environment, if you want one at all. There are many options available to you, ranging from minimalistic window managers like Openbox, to full-featured desktop environments like KDE, and GNOME.

You may find yourself saying "well, I like the idea of having a lightweight graphical environment, but I don't want to install and configure every component individually like with Openbox." For quite some time, such users installed Xfce. While it provided a nice fully-featured environment without the system intensities of KDE or GNOME, it could still become a bit on the heavy side. Now, you have another choice: the Lightweight X11 Desktop Environment, or LXDE for short.

Components of LXDE

LXDE, being a desktop environment, is comprised of several components. Each program offers a certain functionality, and together they form the complete desktop environment. Currently, there are eleven core components, and several other programs necessary to make a complete LXDE installation. These programs are the ones pulled in by the lxde-base/lxde-meta LXDE meta package, discussed in the installation section.

Core Components

Other Applications used by LXDE


Initial installation

After emerging and configuring x11-base, LXDE is ready for installation:

root #emerge --ask lxde-base/lxde-meta

Just like with other desktop environments, the X Server must be told to load LXDE automatically, by adding it to the ~/.xinitrc file:

user $echo "exec startlxde" >> ~/.xinitrc

This will automatically start a LXDE session when startx is run at the terminal.

Those using a login manager like LXDM, SLiM, XDM, GDM, or KDM, editing the ~/.xinitrc file is not necessary. LXDE will simply show up as a choice in the login manager's screen.
Since each user has their own .xinitrc file, make sure to issue that command as each respective user (not as the root user). This will happen by default as long as the sudo or su commands are invoked on startx in the ~/.xinitrc file.


GTK icon warning

Now that the X server knows to start LXDE on command, type in startx to fire up LXDE. The first thing you may notice is that you get a warning about an improper GTK icon set. To fix this minor hangup, you simply need to change the icon theme. To do so, click on the LXDE application menu (in the lower left-hand corner of the panel), and go to Preferences --> Appearance. In the LXappearance menu, click on the "Icon" tab, and choose nuoveXT.2.2. Hit "Apply," and then "Close." The next time you login to LXDE, the error message will not appear.

Right-click menu

In LXDE, every appearance option is not handled through LXappearance as one might believe. Rather, there are some common options that are handled through a right-click menu on the desktop. At the bottom of that menu is the "Desktop Settings" menu. In here, you can find icon sizes, single-click and double-click behavior, maximum thumbnail size, and desktop wallpaper settings. It may behoove you to look through the these tabs for additional appearance settings.

These "Desktop Settings" can also be found by opening up the file manager (PCManFM), and going to Edit --> Preferences.

External resources

Though this guide will help you get LXDE installed, the documentation does not stop here. There are many resources available to you regarding the various facets of the Lightweight X11 Desktop Environment. Some such resources are listed below:

  • On the Official LXDE website you will find information regarding developmental progress, a community of support, and recommend system specifications for running LXDE.
  • The LXDE wiki contains instructions for customizing your LXDE installation, including keyboard layouts, autostarting applications, changing the default window manager, and much more.
  • The Openbox Guide will help users get started using Openbox as their default window manager.

This article is based on a document formerly found on our main website gentoo.org.
The following people contributed to the original document: kalos, yngwin, vostorga, hwoarang
They are listed here as the Wiki history does not allow for any external attribution. If you edit the Wiki article, please do not add yourself here; your contributions are recorded on the history page.