https://github.com/the-cavalry/light-locker

A simple session-locker for lightdm
https://github.com/the-cavalry/light-locker

Last synced: 3 months ago
JSON representation

A simple session-locker for lightdm

• Host: GitHub
• URL: https://github.com/the-cavalry/light-locker
• Owner: the-cavalry
• License: gpl-2.0
• Created: 2013-02-04T23:43:24.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2022-11-12T17:29:49.000Z (about 2 years ago)
• Last Synced: 2024-08-01T03:29:53.816Z (5 months ago)
• Language: C
• Homepage:
• Size: 15.4 MB
• Stars: 222
• Watchers: 15
• Forks: 22
• Open Issues: 72
• Metadata Files:
  • Readme: README
  • License: COPYING

Awesome Lists containing this project

• stars - the-cavalry/light-locker - locker for lightdm (HarmonyOS / Windows Manager)

README

        
# light-locker

light-locker is a simple locker (forked from gnome-screensaver) that aims to have simple, sane, secure defaults and be well integrated with the desktop while not carrying any desktop-specific dependencies.

It relies on lightdm for locking and unlocking your session via UPower or logind/systemd.

## Requirements

To use light-locker with systemd, you need at least lightdm 1.7.0.

light-locker doesn't work with lightdm version 1.7.5-1.7.9

## Usage

After installing light-locker, it will auto start along your session and you will be able to lock your session with "light-locker-command -l".

This will redirect you to VT8 (assuming that your open session was on VT7 and is now kept safe by light-locker) and present LightDM's greeter for unlocking your session again.

On suspend/resume light-locker will lock the active session and redirect to the LightDM's greeter for unlocking the session again.

There is no support for gnome-settings-daemon in order to keep things slim, so you might have to add a custom keyboard-shortcut for this to work.

light-locker will automatically lock the session shortly after the X11 screen saver kicks in. The timeout can be set with --lock-after-screensaver. With xset the X11 screen saver can be adjusted.

Use --late-locking to avoid some of the negative effects of VT switching. This will lock the session on the deactivation of X11 screen saver instead of activation.

light-locker will automatically lock the session on suspend/resume. To disable this behaviour with --no-lock-on-suspend.

With --lock-on-lid light-locker will automatically lock the lid close.

With logind sessions can have an idle hint. This is used to perform some action after a timeout. Use --idle-hint to let light-locker set the idle hint, in case nothing else does.

## Building

light-locker different configurable dependencies and some of these require the development files to be installed.

Most of these configurations will be enabled automatically when their dependencies are available.

Here is a list of the different dependencies and their configuration flags:

  --with-systemd: This adds the support for systemd logind. This option requires the development files to be installed.

  --with-upower: This adds the support for UPower.

  --with-mit-ext: This enables the lock-after-screensaver feature. This options requires the X11 Screen Saver extension development files to be installed.

  --with-dpms-ext: This adds the support for DPMS. This is used to turn on the display on screen saver deactivation.

Many of the light-locker features can be disabled/enabled and configured at build time. Here is a list of these configuration flag:

  --enable-late-locking: Enables --late-locking and --no-late-locking. Default enabled with --no-late-locking. This requires mit-ext.

  --enable-lock-on-suspend: Enables --lock-on-suspend and --no-lock-on-suspend. Default enabled with --lock-on-suspend. This requires either systemd or upower.

  --enable-lock-on-lid: Enables --lock-on-lid and --no-lock-on-lid. Default enabled with --no-lock-on-suspend. This requires upower.

## Users

Known users of light-locker are:

  * elementary OS

  * XFCE