Linux command
swayidle 命令
文本
复制后可按需替换文件名、目录或参数。
常用示例
Lock screen on idle
swayidle timeout [300] 'swaylock -f'
Turn off display
swayidle timeout [600] 'swaymsg "output * dpms off"' resume 'swaymsg "output * dpms on"'
Lock before sleep
swayidle before-sleep 'swaylock -f'
Multiple timeouts
swayidle timeout [300] 'swaylock -f' timeout [600] 'systemctl suspend'
With lock event
swayidle lock 'swaylock -f'
说明
swayidle is an idle management daemon compatible with any Wayland compositor implementing the ext-idle-notify protocol. It triggers commands based on user inactivity, supporting 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.
- resume _COMMAND_
- Run on activity.
- before-sleep _COMMAND_
- Run before suspend.
- after-resume _COMMAND_
- Run after wake.
- lock _COMMAND_
- Run on lock event.
- unlock _COMMAND_
- Run on unlock.
- -w
- Wait for command to finish before continuing
- -d
- Enable debug output
- -C _path_
- Path to config file (default: $XDG_CONFIG_HOME/swayidle/config)
- -S _seat_
- Specify seat name to use
FAQ
What is the swayidle command used for?
swayidle is an idle management daemon compatible with any Wayland compositor implementing the ext-idle-notify protocol. It triggers commands based on user inactivity, supporting 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.
How do I run a basic swayidle example?
Run `swayidle timeout [300] 'swaylock -f'` in a terminal, then adjust file names, paths, flags, or remote targets for your system.
What does timeout _SECONDS_ _COMMAND_ do in swayidle?
Run after idle time.