betterlockscreen

Lock screen

$ betterlockscreen -l

$ betterlockscreen -u path/to/image.png

$ betterlockscreen -l pixel --text "Custom text"

$ betterlockscreen --off 5 -l

betterlockscreen [OPTIONS]

betterlockscreen is a lock screen wrapper for i3lock-color that provides visually appealing lock screens with customizable background effects. It supports dim, blur, dimblur, and pixel effects applied to a wallpaper image.
Before locking, the background image must be cached using the -u flag, which generates processed versions with each effect. This makes subsequent locks instant since the effects are pre-computed. The tool can also set the desktop wallpaper using the same cached images.

-l, --lock [effect]

Lock the screen (effects: dim, blur, dimblur, pixel)

Update lock screen background image

Display custom text on lock screen

Turn off monitor after specified seconds

Set desktop wallpaper

~/.config/betterlockscreenrc

Configuration file for default effects, colors, font settings, and lock screen appearance.

Requires i3lock-color and imagemagick. Background images are cached for faster locking. First-time setup requires running -u to generate cached images.

betterlockscreen is a wrapper script enhancing i3lock with blur and pixel effects.

i3lock(1), xscreensaver(1)