Difference between revisions of "LXDM"

From ArchWiki
Jump to: navigation, search
(Configuration: reordered and added bit about face icons)
(cleanup page, remove Troubleshooting section as all problems were solved)
(45 intermediate revisions by 12 users not shown)
Line 1: Line 1:
 
[[Category:Display managers]]
 
[[Category:Display managers]]
 
[[zh-CN:LXDM]]
 
[[zh-CN:LXDM]]
{{Article summary start}}
+
{{Related articles start}}
{{Article summary text|
+
{{Related|LXDE}}
LXDM is the lightweight display manager aimed to replace gdm in LXDE distros. The UI is implemented with GTK+. It is still in early stages of development.}}
+
{{Related|Display manager}}
{{Article summary heading|Related}}
+
{{Related articles end}}
{{Article summary wiki|Display_Manager}}
+
 
{{Article summary end}}
+
LXDM is the lightweight display manager aimed to replace gdm in LXDE distros. The UI is implemented with GTK+. It is still in early stages of development.
  
 
==Installation==
 
==Installation==
[[pacman|Install]] the {{pkg|lxdm}} package which is available in the [[Official Repositories|official repositories]].
+
The {{pkg|lxdm}} package is available in the [[Official Repositories|official repositories]] or {{AUR|lxdm-git}} is available in the [[AUR]].
  
 
== Usage ==
 
== Usage ==
 
Currently, {{pkg|lxdm}} provides an lxdm.service file.  Enable it like any other systemd service:
 
Currently, {{pkg|lxdm}} provides an lxdm.service file.  Enable it like any other systemd service:
  # systemctl enable lxdm.service
+
  # systemctl enable lxdm
  
 
==Configuration==
 
==Configuration==
{{warning|1=The language select control in '''lxdm.conf''' is sometimes required and sometimes not. Set '''lang=''' to inverse value of itself when LXDM potentially enters a boot loop and fails to load your session.}}
+
The configuration files for LXDM are all located in {{ic|/etc/lxdm/}}. The main configuration file is {{ic|lxdm.conf}}, and is well documented in its comments. Another file, {{ic|Xsession}}, is the systemwide x session configuration file and should generally not be edited. The other files in this folder are all shell scripts, which are run when certain events happen in LXDM.
The configuration files for LXDM are all located in {{ic|/etc/lxdm}}. The main configuration file is {{ic|lxdm.conf}}, and is well documented in its comments. Another file, {{ic|Xsession}}, is the systemwide x session configuration file and should generally not be edited. The other files in this folder are all bash scripts, which are run when certain events happen in LXDM.
+
  
 
These are:
 
These are:
# {{ic|LoginReady}}: Is executed with root privileges when LXDM is ready to show the login window.
+
# {{ic|LoginReady}} is executed with root privileges when LXDM is ready to show the login window.
# {{ic|PreLogin}}: Is run as root before logging a user in.
+
# {{ic|PreLogin}} is run as root before logging a user in.
# {{ic|PostLogin}}: Is run as the logged-in user right after they have logged in.
+
# {{ic|PostLogin}} is run as the logged-in user right after he has logged in.
# {{ic|PostLogout}}: Is run as the logged-in user right after they have logged out.
+
# {{ic|PostLogout}} is run as the logged-in user right after he has logged out.
# {{ic|PreReboot}}: Is run as root before rebooting with LXDM.
+
# {{ic|PreReboot}} is run as root before rebooting with LXDM.
# {{ic|PreShutdown}}: Is run as root before poweroff with LXDM.
+
# {{ic|PreShutdown}} is run as root before poweroff with LXDM.
  
=== Unlocking Keyrings upon Login===
+
===Default session===
  
When using a key manager such as gnome-keyring to manage passwords for ssh keys, {{ic|/etc/pam.d/lxdm}} should be adjusted to allow users to unlock keyrings upon login if desired. The following is a functional configuration:
+
It can be specified which session will be loaded when the users select the 'Default' session from the session list. Note that the user setting takes preference over global setting.
  
#%PAM-1.0
+
==== Globally ====
auth            requisite      pam_nologin.so
+
auth            required        pam_env.so
+
auth            required        pam_unix.so
+
auth            optional        pam_gnome_keyring.so
+
account        required        pam_unix.so
+
session        required        pam_limits.so
+
session        required        pam_unix.so
+
session        optional        pam_gnome_keyring.so auto_start
+
password        required        pam_unix.so
+
  
=== Adding Face Icons ===
+
Edit {{ic|/etc/lxdm/lxdm.conf}} and change the session line to whatever session or DE is desired:
A 96x96 px image (jpg or png) can optionally be displayed on a per-user basis replacing the stock icon.  Simply copy or symlink the target image to {{ic|$HOME/.face}}.
+
  
The {{Pkg|gnome-control-center}} package supplies some default icons suitable for the lxdm screen.  Look under {{ic|/usr/share/pixmaps/faces}} after installing that package.
+
{{bc|session<nowiki>=</nowiki>/usr/bin/startlxde}}
  
{{Note|Users need not keep {{Pkg|gnome-control-center}} installed to use this images.  Simply install it, copy them elsewhere, and remove it.}}
+
Example using xfce:
 +
{{bc|session<nowiki>=</nowiki>/usr/bin/startxfce4}}
  
===Default session===
+
Example using openbox:
==== Globally ====
+
{{bc|session<nowiki>=</nowiki>/usr/bin/openbox-session}}
Edit {{ic|/etc/lxdm/lxdm.conf}} and change the line:
+
  
{{bc|session<nowiki>=</nowiki>/usr/bin/startlxde}}
+
Example using GNOME:
 +
{{bc|session<nowiki>=</nowiki>/usr/bin/gnome-session}}
  
To whatever session or DE is desired. To use xfce you would modify it to:
+
This is useful for themes that have no visible session selection box, and if experiencing trouble using autologin.
  
{{bc|session<nowiki>=</nowiki>/usr/bin/startxfce4}}
+
==== Per user ====
  
This is useful for themes that have no visible session selection box, or if you're experiencing trouble using autologin.
 
 
==== Per user ====
 
 
To define an individual user's preferred session, simply edit his/her respective {{ic|~/.dmrc}} to define the selection.
 
To define an individual user's preferred session, simply edit his/her respective {{ic|~/.dmrc}} to define the selection.
  
Line 81: Line 68:
 
To log in to one account automatically, without providing a password, find the line in {{ic|/etc/lxdm/lxdm.conf}} that looks like this:
 
To log in to one account automatically, without providing a password, find the line in {{ic|/etc/lxdm/lxdm.conf}} that looks like this:
 
  #autologin=username
 
  #autologin=username
Uncomment it, then substitute your own username instead of "username".
+
Uncomment it, substituting the target user instead of "username".
 
+
This will cause LXDM to automatically login to the specified account when it first starts up.  However, if one were to log out of that account, one would have to enter its password to log back into it; if the password was empty, that user will be unable to log into the account.  To remedy this and be able to log into the account without entering a password, first delete the password:
+
  
 +
This will cause LXDM to automatically login to the specified account when it first starts up.  However, if one were to log out of that account, one would have to enter its password to log back into it. To avoid this, delete the password:
 
  $ passwd -d USERNAME
 
  $ passwd -d USERNAME
  
Then, edit the PAM file for LXDM, which is {{ic|/etc/pam.d/lxdm}}.  The files in this directory describe how users are authenticated by the various installed programs that need to do some sort of authentication.  Change the line that says
+
===Shutdown and reboot commands===
 +
Shutdown and reboot commands can be configured in {{ic|/etc/lxdm/lxdm.conf}} by adding the [cmd] section:
  
  auth    required    pam_unix.so
+
  [cmd]
 +
# reboot command
 +
reboot=/usr/bin/systemctl reboot
 +
 +
# shutdown command
 +
shutdown=/usr/bin/systemctl poweroff
  
to this:
+
==Tips and tricks==
  
  auth    required    pam_unix.so nullok
+
=== Adding face icons ===
 +
A 96x96 px image (jpg or png) can optionally be displayed on a per-user basis replacing the stock icon. Simply copy or symlink the target image to {{ic|$HOME/.face}}. The {{Pkg|gnome-control-center}} package supplies some default icons suitable for the lxdm screen. Look under {{ic|/usr/share/pixmaps/faces}} after installing that package.
  
This will tell the pam_unix authentication module that blank passwords are to be accepted. After making this change, LXDM will log into accounts with blank passwords.
+
{{Note|Users need not keep {{Pkg|gnome-control-center}} installed to use this images.  Simply install it, copy them elsewhere, and remove it.}}
  
===Expected Logout Behavior===
+
=== Simultaneous users and switching users ===
What might be slightly surprising with LXDM is that, by default, it does not clear the last user's desktop background or kill the user's processes when that user logs out.  Users desiring this behavior, can edit {{ic|/etc/lxdm/PostLogout}} like this:
+
LXDM allows multiple users to be logged into different ttys at the same time.  The following command is used to allow another user to login without logging out the current user:
  
  #!/bin/sh
+
  $ lxdm -c USER_SWITCH
+
# Kills all your processes when you log out.
+
killall --user $USER -TERM
+
+
# Sets the desktop background to solid black. Useful if you have multiple monitors.
+
xsetroot -solid black
+
  
{{note|This will kill daemons such as tmux, urxvtd, etc.}}
+
{{Note|When the new user logs in, his/her session is now on the NEXT tty from tty7. For example, user1 logs in and issues the USER_SWITCH command. Now user2 logs in. User2 will be on tty7 while user1 will be on tty1.}}
  
Or you can replace killall command with this to exclude ssh and screen processes from termination:
+
If you use the [[Xfce]] desktop, the Switch User functionality of its Action Button panel item specifically looks for the ''gdmflexiserver'' executable in order to enable itself. If you provide it with an executable shell script {{ic|/usr/bin/gdmflexiserver}} consisting of
  
ps --user $USER | egrep -v "ssh|screen" | cut -b11-15 | xargs -t kill
+
  #!/bin/sh
 +
  /usr/bin/lxdm -c USER_SWITCH
  
=== Sessionlist===
+
then user switching in Xfce should work fine also with LXDM.
  
To add/remove entries to LXDM's session dropdown menu; create/remove the .desktop files in /usr/share/xsessions as desired. A typical .desktop file will look something like:
+
[[Xscreensaver]] can also perform this task.  For more, see the [[Xscreensaver#LXDM]] article.
  
[Desktop Entry]
+
=== Themes ===
Encoding=UTF-8
+
The LXDM themes are localized in /usr/share/lxdm/themes
Name=Openbox
+
Comment=Log in using the Openbox window manager (without a session manager)
+
Exec=/usr/bin/openbox-session
+
TryExec=/usr/bin/openbox-session
+
Icon=openbox.png
+
Type=XSession
+
  
=== Simultaneous Users and Switching Users ===
+
There is only one theme provided with LXDM, namely IndustrialTo display the background file wave.svg which is part of this theme, make sure you have {{pkg|librsvg}} installed.
LXDM allows multiple users to be logged into different ttys at the same timeThe following command is used to allow another user to login without logging out the current user:
+
  
$ lxdm -c USER_SWITCH
+
There are 2 themes provided with {{aur|lxdm-git}}ArchStripes and ArchDark.
 
+
You can configure them on /etc/lxdm/lxdm.conf in theme=theme_name
{{Note|When the new user logs in, his/her session is now on the NEXT ttyFor example, user1 logs in and issues the USER_SWITCH command. Now user2 logs in.  User2 will be on tty8 while user1 will be on tty7.}}
+
 
+
[[Xscreensaver]] can also perform this task.  For more, see the [[Xscreensaver#LXDM]] article.
+

Revision as of 19:21, 26 November 2013

Related articles

LXDM is the lightweight display manager aimed to replace gdm in LXDE distros. The UI is implemented with GTK+. It is still in early stages of development.

Installation

The lxdm package is available in the official repositories or lxdm-gitAUR is available in the AUR.

Usage

Currently, lxdm provides an lxdm.service file. Enable it like any other systemd service:

# systemctl enable lxdm

Configuration

The configuration files for LXDM are all located in /etc/lxdm/. The main configuration file is lxdm.conf, and is well documented in its comments. Another file, Xsession, is the systemwide x session configuration file and should generally not be edited. The other files in this folder are all shell scripts, which are run when certain events happen in LXDM.

These are:

  1. LoginReady is executed with root privileges when LXDM is ready to show the login window.
  2. PreLogin is run as root before logging a user in.
  3. PostLogin is run as the logged-in user right after he has logged in.
  4. PostLogout is run as the logged-in user right after he has logged out.
  5. PreReboot is run as root before rebooting with LXDM.
  6. PreShutdown is run as root before poweroff with LXDM.

Default session

It can be specified which session will be loaded when the users select the 'Default' session from the session list. Note that the user setting takes preference over global setting.

Globally

Edit /etc/lxdm/lxdm.conf and change the session line to whatever session or DE is desired:

session=/usr/bin/startlxde

Example using xfce:

session=/usr/bin/startxfce4

Example using openbox:

session=/usr/bin/openbox-session

Example using GNOME:

session=/usr/bin/gnome-session

This is useful for themes that have no visible session selection box, and if experiencing trouble using autologin.

Per user

To define an individual user's preferred session, simply edit his/her respective ~/.dmrc to define the selection.

Example: user1 wants xfce4, user2 wants cinnamon, and user3 wants gnome:

For user1:

[Desktop]
Session=xfce

For user2:

[Desktop]
Session=cinnamon

For user3:

[Desktop]
Session=gnome

Autologin

To log in to one account automatically, without providing a password, find the line in /etc/lxdm/lxdm.conf that looks like this:

#autologin=username

Uncomment it, substituting the target user instead of "username".

This will cause LXDM to automatically login to the specified account when it first starts up. However, if one were to log out of that account, one would have to enter its password to log back into it. To avoid this, delete the password:

$ passwd -d USERNAME

Shutdown and reboot commands

Shutdown and reboot commands can be configured in /etc/lxdm/lxdm.conf by adding the [cmd] section:

[cmd]
# reboot command
reboot=/usr/bin/systemctl reboot

# shutdown command
shutdown=/usr/bin/systemctl poweroff

Tips and tricks

Adding face icons

A 96x96 px image (jpg or png) can optionally be displayed on a per-user basis replacing the stock icon. Simply copy or symlink the target image to $HOME/.face. The gnome-control-center package supplies some default icons suitable for the lxdm screen. Look under /usr/share/pixmaps/faces after installing that package.

Note: Users need not keep gnome-control-center installed to use this images. Simply install it, copy them elsewhere, and remove it.

Simultaneous users and switching users

LXDM allows multiple users to be logged into different ttys at the same time. The following command is used to allow another user to login without logging out the current user:

$ lxdm -c USER_SWITCH
Note: When the new user logs in, his/her session is now on the NEXT tty from tty7. For example, user1 logs in and issues the USER_SWITCH command. Now user2 logs in. User2 will be on tty7 while user1 will be on tty1.

If you use the Xfce desktop, the Switch User functionality of its Action Button panel item specifically looks for the gdmflexiserver executable in order to enable itself. If you provide it with an executable shell script /usr/bin/gdmflexiserver consisting of

 #!/bin/sh
 /usr/bin/lxdm -c USER_SWITCH

then user switching in Xfce should work fine also with LXDM.

Xscreensaver can also perform this task. For more, see the Xscreensaver#LXDM article.

Themes

The LXDM themes are localized in /usr/share/lxdm/themes

There is only one theme provided with LXDM, namely Industrial. To display the background file wave.svg which is part of this theme, make sure you have librsvg installed.

There are 2 themes provided with lxdm-gitAUR. ArchStripes and ArchDark. You can configure them on /etc/lxdm/lxdm.conf in theme=theme_name