Browse Source

Updated README. More dependencies!

sisyphus
JezerM 3 years ago
parent
commit
2464e3bd80
No known key found for this signature in database
GPG Key ID: 66BBC5D01388C6B5
  1. 33
      README.md

33
README.md

@ -41,13 +41,16 @@ apt install ./web-greeter-VER.deb
``` ```
## Dependencies ## Dependencies
| | arch | ubuntu | fedora | openSUSE | | | arch | ubuntu | fedora | openSUSE |
|--------------------------|---------------------|----------------------|---------------------|----------------------| |--------------------------|----------------------|-------------------------|---------------------|----------------------|
|**liblightdm-gobject** |lightdm |liblightdm-gobject-dev|lightdm-gobject-devel|liblightdm-gobject-1-0| |**liblightdm-gobject** |lightdm |liblightdm-gobject-1-dev |lightdm-gobject-devel|liblightdm-gobject-1-0|
|**pygobject** |python-gobject |python3-gi |pygobject3 |python3-gobject | |**pygobject** |python-gobject |python3-gi |pygobject3 |python3-gobject |
|**pyqt5** |python-pyqt5 |python3-pyqt5 |python3-qt5 |python3-qt5 | |**pyqt5** |python-pyqt5 |python3-pyqt5 |python3-qt5 |python3-qt5 |
|**qt5-webengine** |qt5-webengine |libqt5webengine5 |qt5-qtwebengine |libqt5-qtwebengine | |**pyqt5-webengine** |python-pyqt5-webengine|python3-pyqt5.qtwebengine|python3-qt5-webengine|python3-qtwebengine |
|**gobject-introspection** |gobject-introspection|gobject-introspection |gobject-introspection|gobject-introspection | |**python-xlib** |python-xlib |python3-xlib |python3-xlib |python3-xlib |
|**python-yaml** |python-ruamel-yaml |python3-ruamel.yaml |python3-ruamel-yaml |python3-ruamel-yaml |
|**qt5-webengine** |qt5-webengine |libqt5webengine5 |qt5-qtwebengine |libqt5-qtwebengine |
|**gobject-introspection** |gobject-introspection |gobject-introspection |gobject-introspection|gobject-introspection |
### Build dependencies ### Build dependencies
@ -64,22 +67,24 @@ apt install ./web-greeter-VER.deb
- ruamel.yaml - ruamel.yaml
- python-xlib - python-xlib
Install PIP dependencies with: PIP dependencies are no longer required as long as common dependencies are satisfied. However, you
can install PIP dependencies with:
```sh ```sh
pip install -r requirements.txt pip install -r requirements.txt
``` ```
> ***NOTE*** Be sure to install pip libraries as root too, or use a venv to install these dependencies > ***NOTE*** If using PIP, be sure to install these dependencies as root
## Download & Install ## Download & Install
```sh ```sh
git clone https://github.com/JezerM/web-greeter.git git clone https://github.com/JezerM/web-greeter.git
cd web-greeter cd web-greeter
sudo pip install -r requirements.txt
sudo make install sudo make install
``` ```
This will build and install **web-greeter** in a zippy way, which compresses the python code as a zip and uses it as a binary. Either `sudo make install_freeze` to build and install with cx_freeze. The zippy method depends on the actual python interpreter and its libraries, so you could have problems when updating python or removing any dependency, while the cx_freeze method tries to fix this "problem". This will build and install **web-greeter** in a zippy way, which compresses the python code as a
zip and uses it as a binary.
See [latest release][releases]. See [latest release][releases].
@ -101,12 +106,12 @@ To control the brightness inside the greeter, I recommend to use [acpilight][acp
udev rules are needed to be applied before using it. Then, lightdm will need to be allowed to change backlight values, to do so add lightdm user to **video** group: `sudo usermod -a -G video lightdm` udev rules are needed to be applied before using it. Then, lightdm will need to be allowed to change backlight values, to do so add lightdm user to **video** group: `sudo usermod -a -G video lightdm`
If you don't want to or don't have a compatible device, disable it inside `/etc/lightdm/web-greeter.yml` (disabled by default) Enable it inside `/etc/lightdm/web-greeter.yml`
### Battery status ### Battery status
`acpi` is the only tool you need (and a battery). `acpi` is the only tool you need (and a battery).
You can disable it inside `/etc/lightdm/web-greeter.yml` (disabled by default) You can enable it inside `/etc/lightdm/web-greeter.yml`
## Debugging ## 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 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`.
@ -125,7 +130,7 @@ web-greeter --debug
Before setting **web-greeter** as your LightDM Greeter, you should make sure it does work also with LightDM: Before setting **web-greeter** as your LightDM Greeter, you should make sure it does work also with LightDM:
- Run **web-greeter** as root - Run **web-greeter** as root with `--no-sandbox` flag ("Unable to determine socket to daemon" and "XLib" related errors are expected)
- Run `lightdm --test-mode`. Although it's not supported, it could help to debug lightdm. - Run `lightdm --test-mode`. Although it's not supported, it could help to debug lightdm.
### LightDM crashes and tries to recover over and over again ### LightDM crashes and tries to recover over and over again

Loading…
Cancel
Save