https://wiki.archlinux.org/api.php?action=feedcontributions&user=Bernarcher&feedformat=atomArchWiki - User contributions [en]2024-03-19T03:23:46ZUser contributionsMediaWiki 1.41.0https://wiki.archlinux.org/index.php?title=Systemd/Timers&diff=336033Systemd/Timers2014-09-18T21:50:33Z<p>Bernarcher: /* Timer units */</p>
<hr />
<div>{{Lowercase title}}<br />
[[Category:Daemons and system services]]<br />
[[Category:Boot process]]<br />
[[fr:Systemd/cron]]<br />
[[ja:Systemd/cron functionality]]<br />
{{Related articles start}}<br />
{{Related|systemd}}<br />
{{Related|systemd/User}}<br />
{{Related|systemd/Services}}<br />
{{Related|systemd FAQ}}<br />
{{Related|cron}}<br />
{{Related articles end}}<br />
<br />
[[Systemd]] is capable of taking on a significant subset of the functionality of [[Cron]] through built in support for calendar time events (from systemd version 197) as well as monotonic time events. As of systemd version 212, it also has the foundations for being an anacron replacement through the use of the {{ic|Persistent}} and {{ic|OnCalendar}} options in timers.<br />
<br />
While Cron has been a stalwart on the Linux landscape for years, it still provides no way to detect job failures, establish job dependencies, or allocate processes to cgroups. If you require any of this functionality, ''systemd'' provides a good structure to set up job scheduling. While doing so is slightly more cumbersome than relying on ''dcron'' or ''cronie'', the benefits are not insignificant:<br />
<br />
* Status and logging outputs can be got through journalctl. This enables proper debugging.<br />
* Jobs are decoupled from their timers. This allows jobs to be easily run independently of their timers or for multiple timers to trigger a single job.<br />
* Each job can be configured to run in a specific environment (see {{ic|systemd.exec(5)}}).<br />
* Jobs can be made to depend on other systemd units.<br />
<br />
See {{AUR|systemd-crontab-generator}} from the [[AUR]] for a compability layer to Cron.<br />
<br />
== Timer units ==<br />
<br />
These files are systemd unit files with name ending in ''.timer''. Writing these files follows the common options of all unit configuration files. Please refer to [[systemd#Writing custom .service files]] for a quick look at the overall syntax.<br />
<br />
The timer specific configuration options are configured in a {{ic|[Timer]}} section. There are two ways to define when the timed service will be triggered:<br />
<br />
* time relative to a ''starting point'' such as the last boot (using {{ic|OnBootSec}}) or the time the service was last activated (using {{ic|OnUnitActiveSec}}).<br />
* time relative to a ''real time'' (using {{ic|OnCalendar}}).<br />
<br />
For each timer file, a matching unit service file must exist, describing the unit to activate when the timer elapses. By default, this will be a service by the same name as the timer (except for the suffix). For example, {{ic|foo.timer}} will activate and control {{ic|foo.service}}. As the service will be started by the timer, the service does not need an {{ic|[Install]}} section. Instead, you should specify {{ic|1=WantedBy=timers.target}} in the timer's {{ic|[Install]}} section and enable the timer unit. See {{ic|systemd.timer(5)}} for a full list of options available for timer units.<br />
<br />
To see all of your active timers with time details, run:<br />
<br />
{{hc|$ systemctl list-timers|<br />
NEXT LEFT LAST PASSED UNIT ACTIVATES<br />
Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service<br />
Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service<br />
}}<br />
<br />
The {{ic|LAST}} field information is maintained by systemd through {{ic|stamp-*}} files in the {{ic|/var/lib/systemd/timers}} directory. These are zero length files of which the time field will be used. In case the timers get out of sync it may help to delete the stamp file. It will be reconstructed by systemd on the next start of this timer.<br />
<br />
== Example ==<br />
<br />
Every scheduled task requires its own service file. Our example is a backup script which we will set up to run weekly.<br />
<br />
{{hc|/etc/systemd/system/myBackup.service|<nowiki><br />
[Unit]<br />
Description=full system backup<br />
<br />
[Service]<br />
Nice=19<br />
IOSchedulingClass=2<br />
IOSchedulingPriority=7<br />
ExecStart=/path/to/myBackup/script <br />
</nowiki>}}<br />
<br />
There are a couple ways you could make a timer for this service, but the timer ''must'' have the same name as the service (i.e. {{ic|myBackup.timer}}) or specify {{ic|Unit&#61;myBackup.service}}.<br />
<br />
=== Run On Intervals ===<br />
<br />
If you wish to run backups according to a calendar event, use the {{ic|OnCalendar}} option.<br />
<br />
{{hc|/etc/systemd/system/myBackup.timer|<nowiki><br />
[Unit]<br />
Description=weekly full backup<br />
<br />
[Timer]<br />
# see systemd.time(7) manual page for other scheduling options<br />
OnCalendar=weekly<br />
# run immediately if we missed a backup for some reason<br />
Persistent=true<br />
<br />
[Install]<br />
WantedBy=timers.target<br />
</nowiki>}}<br />
<br />
{{Tip|As with cron jobs, running multiple heavy services simultaneously can cause poor performance. Using {{ic|OnCalendar&#61;weekly}} for multiple services, as described above, would cause all of them to be triggered simultaneously (each Monday at midnight). Consider using a more specific setting to avoid conflicts e.g. {{ic|OnCalendar&#61;Wed, 23:15}}. See [[#Parallelization]].}}<br />
<br />
=== Run After Booting ===<br />
<br />
Alternatively, if you want to run backups every time the system boots (and every week while between reboots), you can combine {{ic|OnBootSec}} with {{ic|OnUnitActiveSec}}.<br />
<br />
{{hc|/etc/systemd/system/myBackup.timer|<nowiki><br />
[Unit]<br />
Description=weekly and post-boot backup<br />
<br />
[Timer]<br />
# run 15 minutes after boot time<br />
OnBootSec=15min <br />
# run 1 week after service was last started<br />
OnUnitActiveSec=1w <br />
<br />
[Install]<br />
WantedBy=timers.target<br />
</nowiki>}}<br />
<br />
{{Note|In case of resource-eating services, do not set the timer too close to boot. It could seriously delay your login and X sessions.}}<br />
<br />
=== Management ===<br />
<br />
You do not need to enable or start the service file yourself, simply [[enable]] and [[start]] the timer. Note that the status of the service will be {{ic|inactive}} unless it ''currently running'' due to the timer being triggered.<br />
<br />
== Caveats ==<br />
This describes a few caveats involved when migrating from cron jobs to systemd timer units.<br />
<br />
=== Parallelization ===<br />
Currently, there is no built-in way to spread timers out evenly across a given interval. While {{ic|AccuracySec}} is sometimes offered as a solution, the randomization it implies is designed such that it is synchronised between all local timer units, and is not equivalent to cron’s random delay configuration. E.g., all daily timer units with {{ic|1=AccuracySec=15m}} will trigger the associated jobs at the same point in time between 00:00 and 00:15.<br />
<br />
== See also ==<br />
<br />
* https://fedoraproject.org/wiki/Features/SystemdCalendarTimers - systemd calendar timers on the Fedora Project wiki</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=Systemd/Timers&diff=335923Systemd/Timers2014-09-18T04:31:53Z<p>Bernarcher: Added information how systemd maintains timer sync through stamps-* files.</p>
<hr />
<div>{{Lowercase title}}<br />
[[Category:Daemons and system services]]<br />
[[Category:Boot process]]<br />
[[fr:Systemd/cron]]<br />
[[ja:Systemd/cron functionality]]<br />
{{Related articles start}}<br />
{{Related|systemd}}<br />
{{Related|systemd/User}}<br />
{{Related|systemd/Services}}<br />
{{Related|systemd FAQ}}<br />
{{Related|cron}}<br />
{{Related articles end}}<br />
<br />
[[Systemd]] is capable of taking on a significant subset of the functionality of [[Cron]] through built in support for calendar time events (from systemd version 197) as well as monotonic time events. As of systemd version 212, it also has the foundations for being an anacron replacement through the use of the {{ic|Persistent}} and {{ic|OnCalendar}} options in timers.<br />
<br />
While Cron has been a stalwart on the Linux landscape for years, it still provides no way to detect job failures, establish job dependencies, or allocate processes to cgroups. If you require any of this functionality, ''systemd'' provides a good structure to set up job scheduling. While doing so is slightly more cumbersome than relying on ''dcron'' or ''cronie'', the benefits are not insignificant:<br />
<br />
* Status and logging outputs can be got through journalctl. This enables proper debugging.<br />
* Jobs are decoupled from their timers. This allows jobs to be easily run independently of their timers or for multiple timers to trigger a single job.<br />
* Each job can be configured to run in a specific environment (see {{ic|systemd.exec(5)}}).<br />
* Jobs can be made to depend on other systemd units.<br />
<br />
See {{AUR|systemd-crontab-generator}} from the [[AUR]] for a compability layer to Cron.<br />
<br />
== Timer units ==<br />
<br />
These files are systemd unit files with name ending in ''.timer''. Writing these files follows the common options of all unit configuration files. Please refer to [[systemd#Writing custom .service files]] for a quick look at the overall syntax.<br />
<br />
The timer specific configuration options are configured in a {{ic|[Timer]}} section. There are two ways to define when the timed service will be triggered:<br />
<br />
* time relative to a ''starting point'' such as the last boot (using {{ic|OnBootSec}}) or the time the service was last activated (using {{ic|OnUnitActiveSec}}).<br />
* time relative to a ''real time'' (using {{ic|OnCalendar}}).<br />
<br />
For each timer file, a matching unit service file must exist, describing the unit to activate when the timer elapses. By default, this will be a service by the same name as the timer (except for the suffix). For example, {{ic|foo.timer}} will activate and control {{ic|foo.service}}. As the service will be started by the timer, the service does not need an {{ic|[Install]}} section. Instead, you should specify {{ic|1=WantedBy=timers.target}} in the timer's {{ic|[Install]}} section and enable the timer unit. See {{ic|systemd.timer(5)}} for a full list of options available for timer units.<br />
<br />
To see all of your active timers with time details, run:<br />
<br />
{{hc|$ systemctl list-timers|<br />
NEXT LEFT LAST PASSED UNIT ACTIVATES<br />
Thu 2014-07-10 19:37:03 CEST 11h left Wed 2014-07-09 19:37:03 CEST 12h ago systemd-tmpfiles-clean.timer systemd-tmpfiles-clean.service<br />
Fri 2014-07-11 00:00:00 CEST 15h left Thu 2014-07-10 00:00:13 CEST 8h ago logrotate.timer logrotate.service<br />
}}<br />
<br />
The {{ic|NEXT}} field information is maintained by systemd through {{ic|stamp-*}} files in the {{ic|/var/lib/systemd/timers}} directory. These are zero length files of which the time field will be used. In case the timers get out of sync it may help to delete the stamp file. It will be reconstructed by systemd on the next start of this timer.<br />
<br />
== Example ==<br />
<br />
Every scheduled task requires its own service file. Our example is a backup script which we will set up to run weekly.<br />
<br />
{{hc|/etc/systemd/system/myBackup.service|<nowiki><br />
[Unit]<br />
Description=full system backup<br />
<br />
[Service]<br />
Nice=19<br />
IOSchedulingClass=2<br />
IOSchedulingPriority=7<br />
ExecStart=/path/to/myBackup/script <br />
</nowiki>}}<br />
<br />
There are a couple ways you could make a timer for this service, but the timer ''must'' have the same name as the service (i.e. {{ic|myBackup.timer}}) or specify {{ic|Unit&#61;myBackup.service}}.<br />
<br />
=== Run On Intervals ===<br />
<br />
If you wish to run backups according to a calendar event, use the {{ic|OnCalendar}} option.<br />
<br />
{{hc|/etc/systemd/system/myBackup.timer|<nowiki><br />
[Unit]<br />
Description=weekly full backup<br />
<br />
[Timer]<br />
# see systemd.time(7) manual page for other scheduling options<br />
OnCalendar=weekly<br />
# run immediately if we missed a backup for some reason<br />
Persistent=true<br />
<br />
[Install]<br />
WantedBy=timers.target<br />
</nowiki>}}<br />
<br />
{{Tip|As with cron jobs, running multiple heavy services simultaneously can cause poor performance. Using {{ic|OnCalendar&#61;weekly}} for multiple services, as described above, would cause all of them to be triggered simultaneously (each Monday at midnight). Consider using a more specific setting to avoid conflicts e.g. {{ic|OnCalendar&#61;Wed, 23:15}}. See [[#Parallelization]].}}<br />
<br />
=== Run After Booting ===<br />
<br />
Alternatively, if you want to run backups every time the system boots (and every week while between reboots), you can combine {{ic|OnBootSec}} with {{ic|OnUnitActiveSec}}.<br />
<br />
{{hc|/etc/systemd/system/myBackup.timer|<nowiki><br />
[Unit]<br />
Description=weekly and post-boot backup<br />
<br />
[Timer]<br />
# run 15 minutes after boot time<br />
OnBootSec=15min <br />
# run 1 week after service was last started<br />
OnUnitActiveSec=1w <br />
<br />
[Install]<br />
WantedBy=timers.target<br />
</nowiki>}}<br />
<br />
{{Note|In case of resource-eating services, do not set the timer too close to boot. It could seriously delay your login and X sessions.}}<br />
<br />
=== Management ===<br />
<br />
You do not need to enable or start the service file yourself, simply [[enable]] and [[start]] the timer. Note that the status of the service will be {{ic|inactive}} unless it ''currently running'' due to the timer being triggered.<br />
<br />
== Caveats ==<br />
This describes a few caveats involved when migrating from cron jobs to systemd timer units.<br />
<br />
=== Parallelization ===<br />
Currently, there is no built-in way to spread timers out evenly across a given interval. While {{ic|AccuracySec}} is sometimes offered as a solution, the randomization it implies is designed such that it is synchronised between all local timer units, and is not equivalent to cron’s random delay configuration. E.g., all daily timer units with {{ic|1=AccuracySec=15m}} will trigger the associated jobs at the same point in time between 00:00 and 00:15.<br />
<br />
== See also ==<br />
<br />
* https://fedoraproject.org/wiki/Features/SystemdCalendarTimers - systemd calendar timers on the Fedora Project wiki</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69545LXDE2009-05-27T20:37:07Z<p>Bernarcher: Running LXDE: forgot fully qualified /usr/bin/ck-launch-session</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like [[GDM]] or [[KDM]], you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
The ~/.xinitrc file might not be present in a fresh install. In this case just create a new one with your favorite editor containing this line.<br />
* If your system runs a newer [[HAL]] version which uses consolekit/policykit capabilities, you may want to utilize a console kit session to start LXDE. Just put ck-launch-session before startlxde:<br />
exec ck-launch-session startlxde<br />
in your ~/.xinitrc file. This solves some logout problems you might experience otherwise.<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command ($ representing the bash user prompt):<br />
$ xinit /usr/bin/startlxde<br />
You will need the fully qualified path if there is a default "exec start-some-WM/DE" in your ~/.xinitrc already. Otherwise the system will probably want to start the session in ~/.xinitrc instead.<br />
<br />
It is certainly possible to start a console kit session from the command line as well:<br />
$ xinit /usr/bin/ck-launch-session startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69543LXDE2009-05-27T20:34:00Z<p>Bernarcher: Running LXDE: a few Wiki references added</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like [[GDM]] or [[KDM]], you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
The ~/.xinitrc file might not be present in a fresh install. In this case just create a new one with your favorite editor containing this line.<br />
* If your system runs a newer [[HAL]] version which uses consolekit/policykit capabilities, you may want to utilize a console kit session to start LXDE. Just put ck-launch-session before startlxde:<br />
exec ck-launch-session startlxde<br />
in your ~/.xinitrc file. This solves some logout problems you might experience otherwise.<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command ($ representing the bash user prompt):<br />
$ xinit /usr/bin/startlxde<br />
You will need the fully qualified path if there is a default "exec start-some-WM/DE" in your ~/.xinitrc already. Otherwise the system will probably want to start the session in ~/.xinitrc instead.<br />
<br />
It is certainly possible to start a console kit session from the command line as well:<br />
$ xinit ck-launch-session startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69542LXDE2009-05-27T20:27:28Z<p>Bernarcher: /* Running LXDE */</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
The ~/.xinitrc file might not be present in a fresh install. In this case just create a new one with your favorite editor containing this line.<br />
* If your system runs a newer HAL version which uses consolekit/policykit capabilities, you may want to utilize a console kit session to start LXDE. Just put ck-launch-session before startlxde:<br />
exec ck-launch-session startlxde<br />
in your ~/.xinitrc file. This solves some logout problems you might experience otherwise.<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command ($ representing the bash user prompt):<br />
$ xinit /usr/bin/startlxde<br />
You will need the fully qualified path if there is a default "exec start-some-WM/DE" in your ~/.xinitrc already. Otherwise the system will probably want to start the session in ~/.xinitrc instead.<br />
<br />
It is certainly possible to start a console kit session from the command line as well:<br />
$ xinit ck-launch-session startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69541LXDE2009-05-27T20:24:37Z<p>Bernarcher: Running LXDE: fully qualified /usr/bin/startlxde necessary when starting from command line</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
The ~/.xinitrc file might not be present in a fresh install. In this case just create a new one with your favorite editor containing this line.<br />
* If your system runs a newer HAL version which uses consolekit/policykit capabilities, you may want to utilize a console kit session to start LXDE. Just put ck-launch-session before startlxde:<br />
exec ck-launch-session startlxde<br />
in your ~/.xinitrc file. This solves some logout problems you might experience otherwise.<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command:<br />
xinit /usr/bin/startlxde<br />
You will need the fully qualified path if there is a default "exec start-some-WM/DE" in your ~/.xinitrc already. Otherwise the system will probably want to start the session in ~/.xinitrc instead.<br />
<br />
It is certainly possible to start a console kit session from the command line as well:<br />
xinit ck-launch-session startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69540LXDE2009-05-27T19:58:26Z<p>Bernarcher: Running LXDE: Using ck-launch-session in ~/.xinitrc</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
The ~/.xinitrc file might not be present in a fresh install. In this case just create a new one with your favorite editor containing this line.<br />
* If your system runs a newer HAL version which uses consolekit/policykit capabilities, you may want to utilize a console kit session to start LXDE. Just put ck-launch-session before startlxde:<br />
exec ck-launch-session startlxde<br />
in your ~/.xinitrc file. This solves some logout problems you might experience otherwise.<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command:<br />
xinit /usr/bin/startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69511LXDE2009-05-27T13:13:23Z<p>Bernarcher: Running LXDE: Starting interactively from the console</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
* If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
* If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
exec startlxde<br />
* If you want to start LXDE directly from the command line without fixing the start instructions in ~/.xinitrc (useful if you want to interactively select between Window Managers/Desktop Environments without using a display manager) use this command:<br />
xinit /usr/bin/startlxde<br />
* If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69498LXDE2009-05-27T10:36:28Z<p>Bernarcher: Replace Window Manager /etc/xdg/lxsession/LXDE/defaults is deprecated</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
# If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
# If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
<br />
exec startlxde<br />
<br />
If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
<br />
These default settings however appear to be deprecated, as there is this note in the file:<br />
! This file is kept for backward compatibility.<br />
! Only used by obsolete lxsession, not lxsession-lite.<br />
<br />
Anyhow, for example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=Xcompmgr&diff=69494Xcompmgr2009-05-26T23:14:38Z<p>Bernarcher: * Some Tips section added: Start/stop script *</p>
<hr />
<div>[[Category:X Server (English)]]<br />
[[Category:Eye candy (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
= Introduction =<br />
Xcompmgr is a simple [http://en.wikipedia.org/wiki/Compositing_window_manager composite window manager], capable of rendering drop shadows and, with the use of the <tt>transset</tt> utility, primitive window transparency. Designed solely as a proof-of-concept, xcompmgr is a lightweight alternative to Compiz Fusion and similar composite managers.<br />
<br />
Because it does not replace any existing window manager, it is an ideal solution for [[Openbox]] and [[Fluxbox]] users seeking a more elegant desktop.<br />
<br />
= Prerequisites =<br />
Xcompmgr requires the following:<br />
* [[Xorg]] must be installed, configured and running<br />
* [[Composite]] must be enabled via graphics drivers, [[AIGLX]], or [[Xgl]]<br />
<br />
= Installation =<br />
Both <tt>xcompmgr</tt> and the transparency tool <tt>transset</tt>, are available from the standard repositories:<br />
# pacman -S xcompmgr transset<br />
<br />
= Configuration =<br />
To load xcompmgr, simply run:<br />
$ xcompmgr -c<br />
<br />
To have it load every time X starts, add the following to your <code>~/.xinitrc</code>:<br />
xcompmgr -c &<br />
<br />
Instead of <code>-c</code> you can experiment with the other switches to modify the drop-shadows or even enable fading. Below is a common example:<br />
xcompmgr -c -t-5 -l-5 -r4.2 -o.55 &<br />
<br />
For a full list of options, run:<br />
$ xcompmgr --help<br />
<br />
== Window Transparency ==<br />
<br />
Although its practical use is limited, due to its slow performance, the <tt>transset</tt> utility can be used to set the transparency of individual windows.<br />
<br />
To set the transparency of a program window, make sure the desired program is already running, then execute:<br />
transset ''n''<br />
.. where ''n'' is a number from 0 to 1, zero being transparent and 1 being opaque.<br />
<br />
Once executed, the mouse cursor will transform to a crosshair. Simply click the desired window and the transparency will change to the value specified. For example, <code>transset .25</code> will set the target window to 75% transparency.<br />
<br />
= Troubleshooting =<br />
<br />
<br />
== Fluxbox windows won't raise ==<br />
This is fixed in fluxbox CVS after 0.9.10. See [http://freedesktop.org/bugzilla/show_bug.cgi?id=1264] for more info.<br> A workaround in 0.9.10 is to set the layer of the Slit to "Desktop" (flux menu -> Configure -> Slit -> Layer -> Desktop).<br />
<br />
== Mozilla Firefox crashes when entering a Flash site ==<br />
You can fix it by either creating a executable file in /etc/profile.d called ''flash.sh'' including this line:<br />
export XLIB_SKIP_ARGB_VISUALS=1<br />
Or adding the line into line 184 of /opt/mozilla/bin/firefox.<br />
<br />
= Some Tips =<br />
<br />
== Starting/Stopping xcompmgr on Demand ==<br />
<br />
This script (e.g. in ~/bin) allows easy (re)starting and stopping the composition manager.<br />
#!/bin/bash<br />
#<br />
# Start a composition manager.<br />
# (xcompmgr in this case)<br />
<br />
function comphelp () {<br />
echo "Composition Manager:"<br />
echo " (re)start: COMP"<br />
echo " stop: COMP -s"<br />
echo " query: COMP -q"<br />
echo " returns 1 if composition manager is running, else 0"<br />
exit<br />
}<br />
<br />
function checkcomp () {<br />
( ps -e | grep xcompmgr &>/dev/null ) && exit 1<br />
exit 0<br />
}<br />
<br />
function stopcomp () {<br />
( ps -e | grep xcompmgr &>/dev/null ) && killall xcompmgr<br />
}<br />
<br />
function startcomp () {<br />
stopcomp<br />
# Example settings only. Replace with your own.<br />
xcompmgr -CcfF -I-.015 -O-.03 -D6 -t-1 -l-3 -r4.2 -o.5 &<br />
exit<br />
}<br />
<br />
case "$1x" in<br />
"x") startcomp;;<br />
"-qx") checkcomp;;<br />
"-sx") stopcomp; exit;;<br />
*) comphelp;;<br />
esac<br />
<br />
I bound COMP and COMP -s to two hot keys in IceWM because there are a few glitches using xcompmgr in this WM. This allows for fast restart or temporary composition removal if needed without interrupting other work.<br />
<br />
= Additional Resources =<br />
*[[AIGLX]]<br />
*[[Xgl]]<br />
*[[Composite]] -- A Xorg extension required by composite managers<br />
*[[Compiz Fusion]] -- A composite and window manager offering a rich 3D accelerated desktop environment<br />
*[[Compiz]] -- The original composite/window manager from Novell<br />
*[[Xcompmgr]] -- A simple composite manager capable of drop shadows and primitive transparency<br />
*[[Beryl]] -- <strike>A composite/window manager forked from Compiz</strike> (since merged to become [[Compiz Fusion]])<br />
*Wikipedia: [http://en.wikipedia.org/wiki/Compositing_window_manager Compositing Window Managers]</div>Bernarcherhttps://wiki.archlinux.org/index.php?title=LXDE&diff=69493LXDE2009-05-26T22:50:21Z<p>Bernarcher: /* Replace Window Manager definition is in /etc/xdg/lxsession/LXDE/config */</p>
<hr />
<div>[[Category:Desktop environments (English)]]<br />
[[Category:HOWTOs (English)]]<br />
<br />
{{i18n_links_start}}<br />
{{i18n_entry|English|LXDE}}<br />
{{i18n_entry|简体中文|LXDE (简体中文)}}<br />
{{i18n_entry|Español|LXDE (Español)}}<br />
{{i18n_entry|Italiano|LXDE (italiano)}}<br />
{{i18n_links_end}}<br />
<br />
== What is LXDE? ==<br />
LXDE is the abbreviation for '''L'''ightweight '''X'''11 '''D'''esktop '''E'''nvironment. ''LX'' also stands for ''L''inu''X''. You will find it different from other desktop environments, due to its discrete components, which can be used independently and with few dependencies. <br />
<br />
The LXDE project aims to provide a desktop environment which is intuitive, lightweight and useful, while also keeping system resource demands low. Development focuses on a balance of usability, speed, and memory usage.<br />
<br />
== Why should I use LXDE? ==<br />
LXDE has number of advantages and excellent features:<br />
* '''Lightweight''', runs with reasonable memory usage (After X11 and LXDE are started, the total memory usage is about 45 MB on i386 machines.)<br />
* '''Fast''', runs well even on older machines produced in 1999 (The hardware requirements of LXDE is similar to Windows 98)<br />
* '''Good-looking''', gtk+ 2 internationalized user interface<br />
* '''Easy-to-use''', the user interface is simple, intuitive and functional.<br />
* '''Desktop independent''' (Yes! Every component ''can be used without LXDE'')<br />
* '''Standards compliant''', follows the specs on freedesktop.org<br />
* '''Suitable for old machines''' ( Though LXDE itself has low hardware requirements, other X applications have higher resource demands. For example, Firefox and OpenOffice.org 2 are quite memory-hungry. It is therefore recommended that you have more than 128 MB RAM.)<br />
<br />
== What components does it contain? ==<br />
* '''[[PCManFM]]''': File manager, provides desktop icon and wallpaper.<br />
* '''[http://www.gnomefiles.org/app.php/LXPanel LXPanel]''': Feature-rich desktop panel (if you have problems with this version, use lxpanel-svn from aur)<br />
* '''[http://www.gnomefiles.org/app.php/LXSession LXSession]''': Standard-compliant X11 session manager with shutdown/reboot/suspend supports via HAL and gdm <br />
: (There are some bugs in lxsession related to session management. '''''lxsession-lite''''' is a version of lxsession which does not have the session management capability. The stability of lxsession-lite is better than lxsession, however it can not save and restore sessions. Thus it is recommended to use '''''lxsession-lite''''' till the problems in lxsession are fixed.)<br />
* '''[http://www.gnomefiles.org/app.php/LXAppearance LXAppearance]''': LXAppearance is a new feature-rich GTK+ theme switcher able to change GTK+ themes, icon themes, and fonts used by applications<br />
* '''[http://icculus.org/openbox/index.php/Main_Page Openbox]''': Lightweight, standard-compliant, and highly-configurable window manager (This is not developed by LXDE Project, but it's used as default window manager). This can be replaced by any other window manager like icewm, fluxbox, metacity, ...etc.<br />
* '''[http://lxde.sourceforge.net/gpicview/ GPicView]''': A very simple, fast, and lightweight image viewer featuring immediate startup.<br />
* '''[http://tarot.freeshell.org/leafpad/ Leafpad]''': Lightweight and simple text editor(This is not developed by LXDE Project, but it's suggested as the default text editor).<br />
* '''[http://xarchiver.xfce.org/ XArchiver]''': Lightweight, fast, and desktop-independent gtk+-based file archiver (This is not developed by LXDE Project, but you are suggested to use this as default archiver).<br />
* '''[http://lxde.sourceforge.net/about.html LXNM]''' (Still under development. Available through AUR): Lightweight network manager for LXDE supporting wireless connections (Linux-only)<br />
<br />
== How to Install LXDE ==<br />
LXDE is modular. You can pick and choose packages listed above, all of which can be grabbed via Pacman. (Ensure the [extra] and [community] repositories are enabled). For some packages, like LXNM, you might also need to utilize the [[AUR]] repository. <br />
<br />
The minimal obligatory packages which you have to install to run LXDE are Lxde-common, Lxsession, Openbox, and desktop-file-utils. The Openbox package can be replaced by any Window Manager you prefer.<br />
<br />
Install LXDE base packages:<br />
<br />
# pacman -Sy lxde gamin<br />
<br />
This will install the following packages:<br />
<br />
# pacman -Sg lxde<br />
lxde gpicview<br />
lxde lxappearance<br />
lxde lxde-common<br />
lxde lxlauncher<br />
lxde lxpanel<br />
lxde lxrandr<br />
lxde lxsession-lite<br />
lxde lxtask<br />
lxde lxterminal<br />
lxde pcmanfm<br />
gamin<br />
<br />
Gamin is a file and directory monitoring system defined to be a subset of the FAM. However, it doesn't require a system-wide daemon running with root. It runs as general users on demand, so '''no''' manual configuration is needed. Don't add it to the DAEMON list in /etc/rc.conf.<br />
{{Box Note |Gamin conflicts with fam, so you should uninstall fam if you have it. And it's generally safe to remove fam once gamin is available. After you removed fam, don't forget to remove it from the DAEMON list in /etc/rc.conf.}}<br />
<br />
See: http://wiki.lxde.org/en/ArchLinux<br />
<br />
Other packages you may want are: leafpad, the default text editor for LXDE and obconf, a tool for changing openbox themes.<br />
<br />
== Running LXDE ==<br />
# If you are using display managers like GDM or KDM, you should be able to select LXDE directly.<br />
# If you don't have display manager, and want to start lxde from the shell using ''startx'' or ''xinit'', add this line at the end of ~/.xinitrc:<br />
<br />
exec startlxde<br />
<br />
If you want to run ''startx'' at boot without user intervention, take a look at [http://wiki.archlinux.org/index.php/Start_X_at_boot#Starting_X_as_preferred_user_without_logging_in Start X at boot guide].<br />
<br />
== Tips ==<br />
=== Auto Mount === <br />
If you want a removable usb disk to mount automatically by [[PCManFM]], you must install [[HAL]] and add users to hal group. pmount is required for mounting removable devices without root access <br />
<br />
If your removable disk has an NTFS filesystem, you should install [[NTFS Write Support|NTFS-3G]] as well. <br />
Generally, PCManFM works well with [[HAL]]. Currently, there is one bug affecting NTFS users; If you have files or folders on an NTFS filesystem, the names of which contain non-latin characters (ie: Chinese Characters), the files or folders may disappear when opening (or automounting) the NTFS volume. This happens because the lxsession (or lxsession-lite) mounthelper is not correctly parsing the policies and locale option. There is a workaround for this: <br />
<br />
1) Remove the "/sbin/mount.ntfs-3g" which is a symlink. <br />
rm /sbin/mount.ntfs-3g<br />
2) Create a new "/sbin/mount.ntfs-3g" with a new bash script containing: <br />
#!/bin/bash<br />
/bin/ntfs-3g $1 $2 -o locale=en_US.UTF-8<br />
3) Make it executable: <br />
chmod +x /sbin/mount.ntfs-3g <br />
4) Add "NoUpgrade = sbin/mount.ntfs-3g" to pacman.conf under the "[options]"<br />
<br />
=== Autostart Programs ===<br />
The default '''system-wide''' startup config files can be found at /etc/xdg/lxsession/LXDE/autostart. If you choose to edit the autostart programs for '''all users''' you can Open the file /etc/xdg/lxsession/LXDE/autostart with a text editor and add the name of the program(s) you want to start at login.<br />
<br />
The system-wide autostart file can also be overridden by '''user-specific''' ones. If custom user specific config files are found in ~/.config/lxsession, the ones in /etc/xdg/lxsession will be overridden.<br />
<br />
Another way to start programs on session startup is to add their *.desktop<br />
files in ~/.config/autostart.<br />
<br />
=== Digital Clock Applet Settings ===<br />
You can find a manual with a complete list of options (and explainations) [http://tcl.activestate.com/man/tcl8.3/TclCmd/clock.htm here]<br />
<br />
=== lxpanel Add Launcher (application) ===<br />
lxpanel comes with a launcher applet by default and all you need to do to add new apps to it is:<br />
<br />
# Make sure launch bar applet is enabled: <br />
#*1a. right click the panel<br />
#*1b. select "add/remove panel items"<br />
#*1c. make sure "application launch bar" is listed (if it's not, select "add" and add it)<br />
# Right click anywhere on the launch bar applet<br />
# Choose "application launch bar settings"<br />
# Choose "add"<br />
# Direct it to the .desktop file of whatever application you want to add (found in usr/share/applications)<br />
<br />
=== lxpanel Add Launcher (location) ===<br />
To add a launcher to a specific location such as a media hard drive or folder you need to create a .desktop file and save it in /usr/share/applications. You can then add it the same way as adding an application to the panel.<br />
<br />
Here is a custom .desktop file as an example, edit lines "Exec" and "Icon" as needed:<br />
<br />
[Desktop Entry]<br />
Version=1.0<br />
Encoding=UTF-8<br />
Name=media<br />
Exec=pcmanfm /mnt/xbox (basically you're telling pcmanfm to open a specific location - /mnt/xbox in this case)<br />
Icon=xbmc.png (this should be the name of an icon in /usr/share/pixmaps)<br />
Terminal=false<br />
X-MultipleArgs=false<br />
Type=Application<br />
Categories=Application<br />
StartupNotify=true<br />
<br />
=== lxpanel Icons ===<br />
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. <br />
<br />
You can change default icons for applications by taking the following steps:<br />
# Save the new icon to /usr/share/pixmaps <br />
# Use a text editor to open the .desktop file of the program whose icon you want to change (.desktop files can be found in /usr/share/applications)<br />
# Change <br />
Icon=/default/icon/.png <br />
to <br />
Icon=/name/of/new/icon/added/to/pixmaps/.png<br />
<br />
=== Replace Window Manager === <br />
OpenBox, the default window manager of LXDE, can be easily replaced by any one you like, such as fvwm, icewm, dwm and awesome... etc.. <br />
<br />
The window manager LXDE will attempt to use is defined this file:<br />
::/etc/xdg/lxsession/LXDE/config<br />
Per default this is defined as<br />
[Session]<br />
window_manager=openbox-lxde<br />
Replace openbox-lxde with the window manager of your choice.<br />
<br />
It might be also worth looking at:<br />
::/etc/xdg/lxsession/LXDE/default<br />
For example, somebody's /etc/xdg/lxsession/LXDE/default looks like this:<br />
smproxy<br />
openbox<br />
lxpanel<br />
smproxy is a program provided in xorg. It provides session management support for programs which don't know X11 R6 session management protocol.<br />
It is highly recommended you include this line in your desktop.<br />
<br />
=== Shutdown and Reboot from LXDE ===<br />
To be able to shutdown, reboot, suspend and so on from lxde make sure that DBus and HAL are running. Then add your user to the power group. <br />
<br />
# gpasswd -a <USERNAME> power<br />
<br />
If you still encounter problems, add inbetween the <config></config> tags in /etc/PolicyKit/PolicyKit.conf the folowing lines:<br />
<br />
<match action="org.freedesktop.hal.power-management.shutdown"><br />
<return result="yes"/><br />
</match><br />
<match action="org.freedesktop.hal.power-management.reboot"><br />
<return result="yes"/><br />
</match><br />
Restart HAL and watch it work!<br />
<br />
=== Using KDEmod3 applications under LXDE ===<br />
<br />
As older versions of KDEmod[-legacy] are still installed under /opt/kde/bin, they are not automatically recognized by LXDE. To use them, you can either edit your PATH with the following command:<br />
echo 'PATH=$PATH:/opt/kde/bin' >> /etc/rc.local<br />
or you can add the following script to /etc/profile.d:<br />
#!/bin/sh<br />
PATH=$PATH:/opt/kde/bin<br />
Save it as "kde3path.sh" and make it executable:<br />
chmod +x /etc/profile.d/kde3path.sh<br />
<br />
== External Resources ==<br />
* [http://lxde.sourceforge.net LXDE Project]<br />
* [http://forum.lxde.org LXDE Forum]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=180858 The Latest LX... Packages]<br />
* [https://sourceforge.net/project/showfiles.php?group_id=156956 PCMan File Manager]</div>Bernarcher