README.md

Web Greeter for LightDM

       

Install It

Distro Packages

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

From Source

Dependencies

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 https://github.com/Antergos/web-greeter.git /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.

Debugging

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.

web-greeter

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

Translations are managed through Transifex.