swayidle(1)                 General Commands Manual                swayidle(1)

<?><?><?> (NAME)
       swayidle - <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       Wayland

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       swayidle [options] [events...]

<?><?><?><?><?><?><?><?> (OPTIONS)
       -C <path>
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>:
           $XDG_CONFIG_HOME/swayidle/config <?> $HOME/.swayidle/config.
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <<<?><?><?><?><?><?><?><?> (EVENTS)>> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?> <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       -h
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?>.

       -d
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> (debug).

       -w
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> before-sleep <?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?>.

           <?><?><?><?>: <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> swayidle <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> (<?><?><?><?><?>) <?><?><?><?><?>.

       -S <seat-name>
           <?><?><?><?> <?><?><?><?> seat <?><?><?><?> <?><?><?><?><?><?><?>.
           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> seat
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?><?> swayidle <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?> Wayland
       <?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (EVENTS)
       timeout <timeout> <timeout command> [resume <resume command>]
           <?><?><?> <?><?><?><?> <?><?><?> <timeout> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> timeout
           command <?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> "resume <resume command>" <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> resume command
           <?><?><?><?> <?><?><?><?><?> <?><?>.

       before-sleep <command>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           systemd <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           command <?><?> <?><?><?> <?><?> <?><?><?><?> systemd
           <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?>: <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?> InhibitDelayMaxSec <?><?> logind.conf(5) <?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>. <?><?><?><?><?><?>
           <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       after-resume <command>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           systemd <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           command <?><?> <?><?> <?><?> <?><?><?><?> logind <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       lock <command>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           systemd <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> logind <?><?><?><?><?><?> <?><?><?>
           <?><?><?> <?><?><?><?> (session) <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> command <?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       unlock <command>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           systemd <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> logind <?><?><?><?><?><?> <?><?><?>
           <?><?><?> <?><?><?> <?><?><?><?> (session) <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> command <?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

       idlehint <timeout>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?>
           systemd <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
           IdleHint <?><?> <?><?> <?><?> <timeout> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> logind/elogind <?><?><?><?>.
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> idlehint
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> swayidle <?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?><?> <?><?><?> <?> <?><?><?><?>
           SetIdleHint(false) <?><?> <?><?><?><?><?><?><?><?> <?><?><?>.

       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       (shell) <?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?> (SIGNALS)
       <?><?><?><?><?><?><?> swayidle <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?>:

       SIGTERM, SIGINT
           <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> resume
           <?><?> <?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?>
           <?><?><?><?><?><?> swayidle <?><?><?><?><?> <?><?><?><?><?><?><?>.

       SIGUSR1
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> (idle) <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           swayidle -w    timeout 300 'swaylock -f -c 000000'     timeout 600 'swaymsg "output * power off"'        resume 'swaymsg "output * power on"'    before-sleep 'swaylock -f -c 000000'

       <?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> swayidle
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       (inhibition lock) <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> swaylock
       <?><?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> -w
       <?><?> swayidle <?> <?><?><?><?><?><?> -f <?><?> swaylock
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> Drew DeVault
       <sir@cmpwn.com> <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> swayidle<?> <?><?>
       <https://github.com/swaywm/swayidle> <?><?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       sway(5) swaymsg(1) sway-input(5) sway-output(5) sway-bar(5) loginctl(1)

                                  2025-11-06                       swayidle(1)