A custom screen locker for XSecureLock
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
resources
screenshots
src
.gitignore
README.md
meson.build

README.md

the buzzert screen locker

This is a graphical screen locker for X11, for use in conjunction with XSecureLock. It uses PAM for authentication, so you can use it with your Yubikey/fingerprint scanner, etc. as well.

buzzlocker screenshot

Building

This project uses the Meson build system:

meson build
ninja -C build

Installing

By building buzzlocker by itself, you'll end up with a binary called auth_buzzlocker. This is meant to be used in conjunction with XSecureLock, which does all the heavy-lifting with regards to properly locking an X session and ensuring other windows cannot steal focus or cause the locker to disappear somehow. It also handles secure keyboard input to make sure key events don't get delivered to applications in the background.

If you run auth_buzzlocker by itself, you can preview what the screen locker looks like in windowed-form. If you want to use buzzlocker as your screen locker with XSecureLock, all you need to do is set the XSECURELOCK_AUTH environment variable to point to auth_buzzlocker.

So you might want to do:

  1. sudo ninja -C build install
  2. XSECURELOCK_AUTH=/usr/local/bin/auth_buzzlocker xsecurelock

If you want to make it permanent, edit /etc/environment to include this line:

XSECURELOCK_AUTH=/usr/local/bin/auth_buzzlocker xsecurelock

So every time you run xsecurelock by itself, it will use buzzlocker as the GUI.

Configuration

If you have multiple monitors, buzzlocker will appear only on whatever the primary monitor is (according to XRandR). If you want to override this behavior, set the environment variable BUZZLOCKER_MONITOR_NUM to whichever monitor you wish to have buzzlocker appear on.