lightdm-webkit2-greeter/README.md

# lightdm-webkit2-greeter
[![Latest Release](https://img.shields.io/github/release/Antergos/lightdm-webkit2-greeter.svg?style=flat-square)](https://github.com/Antergos/lightdm-webkit2-greeter/releases)     [![Coverity Scan Build Status](https://img.shields.io/coverity/scan/6871.svg?style=flat-square)](https://scan.coverity.com/projects/antergos-lightdm-webkit2-greeter)

## Install It

### Official Distro Packages
* ![antergos](https://dl.dropboxusercontent.com/u/60521097/logo-square26x26.png) `sudo pacman -S lightdm-webkit2-greeter`

### Unofficial Distro Packages
* ![arch](https://dl.dropboxusercontent.com/u/60521097/archlogo26x26.png) `yaourt -S lightdm-webkit2-greeter`
* ![fedora](https://dl.dropboxusercontent.com/u/60521097/fedora-logo.png) [OBS Repo](https://software.opensuse.org/download.html?project=home:antergos&package=lightdm-webkit2-greeter)
* ![openSUSE](https://dl.dropboxusercontent.com/u/60521097/Geeko-button-bling7.png) [1 Click Install](https://software.opensuse.org/ymp/home:antergos/openSUSE_Leap_42.1/lightdm-webkit2-greeter.ymp?base=openSUSE%3ALeap%3A42.1&query=lightdm-webkit2-greeter) | [OBS Repo](https://software.opensuse.org/download.html?project=home:antergos&package=lightdm-webkit2-greeter)

## Build It

### Dependencies
| Name                  | ![arch](https://dl.dropboxusercontent.com/u/60521097/archlogo26x26.png) | ![debian](https://dl.dropboxusercontent.com/u/60521097/openlogo-nd-25.png) | ![fedora](https://dl.dropboxusercontent.com/u/60521097/fedora-logo.png) | ![openSUSE](https://dl.dropboxusercontent.com/u/60521097/Geeko-button-bling7.png) | ![ubuntu](https://dl.dropboxusercontent.com/u/60521097/ubuntu_orange_hex.png)  | 
|-----------------------|-------------------------------------------------------------------------|----------------------------------------------------------------------------|-------------------------------------------------------------------------|-----------------------------------------------------------------------------------|--------------------------------------------------------------------------------|
|liblightdm-gobject-1   |lightdm|liblightdm-gobject-dev | lightdm-gobject-devel | liblightdm-gobject-1-0 | liblightdm-gobject-dev |
|gtk+ 3                 |gtk3   |libgtk-3-0             | gtk3 | gtk3 | libgtk-3-0 |
|webkit2gtk-4.0         |webkitgtk|libwebkit2gtk-4.0-dev| webkitgtk4 | webkit2gtk3 | libwebkit2gtk-4.0-dev |
|dbus-glib-1            |dbus-glib|libdbus-glib-1-dev   | dbus-glib | dbus-1-glib | libdbus-glib-1-dev |
|exo-csource            |exo      |exo-utils            | exo-devel | exo-tools | exo-utils |
|[antergos-wallpapers](http://antergos.com/antergos-wallpapers-0.6.zip)| N/A | N/A| N/A | N/A| N/A |

### How To Build
The process is slightly different depending on how you obtain the source.

#### Use Git To Clone This Repo
```sh
git clone https://github.com/Antergos/lightdm-webkit2-greeter.git greeter
cd greeter
git submodule init && git submodule update
./autogen.sh --prefix=/usr
make
sudo make install
```

#### Download Repo In Archive Format (tar.gz, zip, etc)
```sh
wget https://github.com/Antergos/lightdm-webkit2-greeter/archive/master.zip
unzip master.zip
cd lightdm-web**/themes
rm -rf antergos
wget https://github.com/Antergos/lightdm-webkit-theme-antergos/archive/master.zip
unzip master.zip
mv lightdm** antergos
cd ..
./autogen.sh --prefix=/usr
make
sudo make install
```
### Theme JavaScript API:
The greeter exposes a JavaScript API to greeter themes which they must use to interact with the greeter (in order to facilitate the user login process). The [API Documentation](https://antergos.com/wiki/development/lightdm-webkit2-greeter-theme-javascript-api/) is a W.I.P.