Skip to content
This repository has been archived by the owner. It is now read-only.
A modern, visually appealing greeter for LightDM.
Python JavaScript Shell Makefile Other
Branch: master
Clone or download
karasu Merge pull request #177 from mpetitjean/master
Add Belgian French translation
Latest commit 9252419 Oct 28, 2018

Web Greeter for LightDM

Latest Release  Codacy Grade  CircleCI  Theme API Docs  AUR Votes

Install It

Distro Packages

Distro Install Command/Links
antergos sudo pacman -S lightdm-webkit2-greeter
arch yaourt -S lightdm-webkit2-greeter
fedora dnf copr enable antergos/lightdm-webkit2-greeter
openSUSE 1 Click Install
ubuntu OBS Repo

From Source


antergos    arch ubuntu fedora openSUSE
whither python-whither python3-whither python3-whither python3-whither
liblightdm-gobject lightdm liblightdm-gobject-dev lightdm-gobject-devel liblightdm-gobject-1-0
pygobject python-gobject python3-gi pygobject3 python3-gobject

NOTE: These instructions are for the master branch. To build the latest release, please see the stable branch.

Download & Install

git clone /tmp/greeter
cd /tmp/greeter
sudo make install

Theme JavaScript API

The greeter exposes a JavaScript API to themes which they must use to interact with the greeter (in order to facilitate the user login process). For more details, check out the API Documentation.


You can run the greeter from within your desktop session if you add the following line to the desktop file for your session located in /usr/share/xsessions/: X-LightDM-Allow-Greeter=true.

You have to log out and log back in after adding that line. Then you can run the greeter from command line.


Themes can be opened with a debug console if you set debug_mode to true inside /etc/lightdm/web-greeter.yml.

Note: Do not use lightdm --test-mode as it is not supported.


Translations are managed through Transifex.

You can’t perform that action at this time.