From project home page:
- The "Lightweight X11 Desktop Environment" is an extremely fast-performing and energy-saving desktop environment. Maintained by an international community of developers, it comes with a beautiful interface, multi-language support, standard keyboard short cuts and additional features like tabbed file browsing. LXDE uses less CPU and less RAM than other environments. It is especially designed for cloud computers with low hardware specifications, such as, netbooks, mobile devices (e.g. MIDs) or older computers.
- 1 Installation
- 2 Starting the desktop
- 3 Tips and tricks
- 3.1 Application menu editing
- 3.2 Autostart
- 3.3 Bindings
- 3.4 Cursors
- 3.5 Digital clock applet time
- 3.6 Font settings
- 3.7 Keyboard layout
- 3.8 Screen locking
- 3.9 LXPanel icons
- 3.10 LXPanel menus
- 3.11 Replace Openbox
- 3.12 Shutdown, reboot, suspend and hibernate options (LXSession-logout)
- 4 Troubleshooting
- 5 See also
GTK+ 3 version
An experimental GTK+ 3 build of LXDE can be installed with the lxde-gtk3 group.
Starting the desktop
To use startx, you will need to define LXDE in xinitrc:
See also Start X at login.
Tips and tricks
The application menu works by resolving the
.desktop files located in
/usr/share/applications. Many desktop environments run programs that supersede these settings to allow customization of the menu. LXDE has yet to create an application menu editor but you can manually build them yourself if you are so inclined. Third party menu editor can be found in PUR - lxmed
To add or edit a menu item, create or link to the
.desktop file in
~/.local/share/applications. (The latter two have the advantage of putting your application outside of directories governed by
pacman.) Consult the desktop entry specification on freedesktop.org for structures of
To remove items from the menu, instead of deleting the
.desktop files, you can edit the file and add the following line in the file:
To expedite the process for a good number of files you can put it in a loop. For example:
$ cd /usr/share/applications $ for i in program1.desktop program2.desktop ...; do cp /usr/share/applications/$i \ /home/user/.local/share/applications/; echo "NoDisplay=true" >> \ /home/user/.local/share/applications/$i; done
This will work for all applications except KDE applications. For these, the only way to remove them from the menu is to log into KDE itself and use its menu editor. For every item that you do not want displayed, check the 'Show only in KDE' option. If adding NoDisplay=True will not work, you can add ShowOnlyIn=XFCE.
Applications can be automatically started in several ways.
Each line in
~/.config/lxsession/LXDE/autostart represents a command to be executed. If a line starts with
@, and the command following it crashes, the command is automatically re-executed. For example:
There is also a global autostart file at
Mouse and key bindings (i.e. keyboard shortcuts) are implemented with Openbox. LXDE users should follow the Openbox wiki to edit
An optional GUI for editing the key bindings is provided by the obkey package. Whle it edits
rc.xml by default, you can direct it to the LXDE configuration as follows:
$ obkey ~/.config/openbox/lxde-rc.xml
See  for more information.
LXAppearance, provided by the lxappearance package, is a graphical tool that can determine a number of aspects of the user interface including the cursor theme. Settings configured using LXAppearance are written to
~/.icons/default/index.theme. See also Cursor themes.
Digital clock applet time
You can right click on the digital clock applet on the panel and set how it displays the current time using the strftime format - see man strftime for details.
See Keyboard configuration in Xorg for generic instructions. A keyboard layout applet is included with lxpanel.
See #Autostart for a way to automatically start setxkbmap in LXDE.
LXDE does not come with a screen locker of its own; see List of applications/Security#Screen lockers for alternatives.
/usr/bin/lxlock, called by default from the ScreenLock icon, searches for these applications in this order: light-locker, xscreensaver, gnome-screensaver, slock, xlockmore, i3lock and xdg-utils.
/etc/xdg/lxsession/LXDE/autostart from lxde-common lists XScreenSaver, which will be launched automatically. See #Autostart when using a different locker. See DPMS on how to control the screen saver without external programs.
Default icons used by lxpanel are stored in
/usr/share/pixmaps and any custom icons you want lxpanel to use need to be saved there as well.
You can change default icons for applications by taking the following steps:
- Save the new icon to /usr/share/pixmaps
- Use a text editor to open the
.desktopfile of the program whose icon you want to change in
The panel's menus can be configured in
/etc/xdg/menus/lxde-applications.menu as per the xdg-menu format to work with applications from other sessions (notably MATE) to add some of the function-ability that lxde lacks.
lxsession uses the window manager defined in
~/.config/lxsession/LXDE/desktop.conf. If this file does not exist, it searches in
openbox-lxde in either file with a window manager of choice:
Alternatively, you can autostart
wm --replace using the method defined in #Lxsession where wm is the name of the window manager executable being started. This method does mean that Openbox will be started first on each login and will then immediately be replaced by the autostarted window manager.
Note that since openbox dispatches the desktop-wide keyboard shortcuts in LXDE, users who want to replace it and still use these shortcuts will need to reimplement this functionality themselves. A good option is xbindkeys.
Shutdown, reboot, suspend and hibernate options (LXSession-logout)
This requires installation of upower.
LXPanel crashes with some themes or browsing particular web pages
lxpanel: cairo-scaled-font.c:459: _cairo_scaled_glyph_page_destroy: Assertion `!scaled_font->cache_frozen' failed.
Try install ttf-dejavu in this case.
If lxpanel crashes when browsing particular unicode web pages, try install ttf-droid.
LXPanel uses a smaller icon size for the Task Bar
The icons of running applications do not match the set Icon size in Panel Settings > Geometry - they are 4px smaller which is making some of them blurry. To have clear looking 32px icons in the Task Bar the set Icon size has to be 36px which would blur the icons of the rest of your active Panel Applets. To get around this create additional panel(s) and have them collectively constitute a single continuous looking panel by adjusting the Alignment and Margin in Panel Settings > Geometry.