README

NOTE: The SLiM display manager is no longer maintained. The old website (http://slim.berlios.de) hosted a copy of the Git repository, but this site is now gone. The SLiM display manager is a great piece of software and a great reference for those of you who want to write your own display managers, so I'm uploading my local copy of the code here as a mirror. The last commit to the project was on October 3rd, 2013.

--------------------------------------------------------------------------------

README file for SLiM

Nobuhiro Iwamatsu <iwamatsu@nigauri.org>

INTRODUCTION
    SLiM (Simple Login Manager) is a graphical login manager for X11.
    It aims to be simple, fast and independent from the various
    desktop environments.
    SLiM is based on latest stable release of Login.app by Per Lidén.

    New features:
    - External themes and configuration
    - PNG support with alpha transparency for panel
    - PNG / JPEG support for backgrounds
    - XFT / freetype support
    - Double or single (GDM-style) inputbox support
    - CMake build procedure

INSTALLATION
    see the INSTALL file
    
USAGE

    To launch slim, execute run the slim binary,
    followed by the -d option if you want it to
    run as a daemon in the background (reccommended)
    
    enter username and password to login. The ~/.xinitrc
    file is executed by default, so be sure to have a working
    .xinitrc file in your home.
    
    Special usernames (commands configurable in the config file):
    - console: start console login
    - exit: exit SLiM
    - halt: halt the system
    - reboot: reboot the system
    
    pressing the F11 key executes a user-specified
    command (see the configuration file), the default
    is to take a screenshot if the 'import' program is available.
    
CONFIGURATION
    /usr/etc/slim.conf is the main configuration file.
    Options are explained in the file itself
    
THEMES
    See THEMES

COPYRIGHT
    SLiM is copyright (c) 2004-06 by Simone Rota, Johannes Winkelmann,
    Nobuhiro Iwamatsu and is available under the GNU General Public
    License.
    See the COPYING file for the complete license.

    Image handling code adapted and extended from xplanet 1.0.1,
    copyright (c) 2002-04 by Hari Nair

    Login.app is copyright (c) 1997, 1998 by Per Liden and is 
    licensed through the GNU General Public License.