Skip to main content
otter-lock locks the session over ext-session-lock-v1. It covers every output when loginctl lock-session runs or otter-idle triggers a lock.

Usage

Lock the session:
Bind this to a compositor hotkey. For example Super+L. logind starts otter-lock when a lock is requested. Do not run it as a persistent daemon.

Configuration

Config file: ~/.config/otter-shell/otter-lock.conf
Colors inherit from theme.conf when not set.

Wallpaper background

When otter-wallpaper is running, the lockscreen reads $XDG_RUNTIME_DIR/otter-shell/wallpaper-state for the same wallpaper behind the lock UI.

Authentication

  • PAM password authentication (pam_service config key)
  • Fingerprint via fprintd when enable_fingerprint = true
  • Build with -Denable_pam=false or -Denable_dbus=false disables auth features (developer builds only)

Keybindings