swayidle

Lock screen on idle

$ swayidle timeout [300] 'swaylock -f'

$ swayidle timeout [600] 'swaymsg "output * dpms off"' resume 'swaymsg "output * dpms on"'

$ swayidle before-sleep 'swaylock -f'

$ swayidle timeout [300] 'swaylock -f' timeout [600] 'systemctl suspend'

$ swayidle lock 'swaylock -f'

swayidle [options] [events]

swayidle is an idle management daemon for the Sway Wayland compositor that triggers commands based on user inactivity. It supports multiple timeout events that execute commands after specified periods of idle time, enabling staged power management such as dimming the screen, locking, and eventually suspending.
Resume actions execute when user activity is detected after a timeout, allowing reversal of timeout effects like turning displays back on. The before-sleep and after-resume events integrate with systemd sleep/wake cycles, commonly used to ensure the screen is locked before the system suspends.
Lock and unlock events respond to session lock signals from logind, enabling coordination with external lock requests such as those from the system settings or other applications.

timeout SECONDS COMMAND

Run after idle time.

Run on activity.

Run before suspend.

Run after wake.

Run on lock event.

Run on unlock.

Wait for command.

Wayland/Sway only. Commands run as shell. Audio may prevent idle.

swayidle is the idle manager for Sway compositor. It handles power management and screen locking triggers.

sway(1), swaylock(1), systemd(1)