hypridle

hypridle [options]

hypridle is Hyprland's idle management daemon. After a configured number of idle seconds it runs on-timeout commands (dim the screen, lock, DPMS off, suspend). When input resumes it runs on-resume. It also reacts to logind D-Bus lock/unlock and prepare-sleep events so the session can lock before suspend.A config file is required; hypridle will not start without one. Add `hypridle` to Hyprland autostart, or enable hypridle.service if the session is started with uwsm.

-c, --config file

Path to the configuration file.

Verbose logging.

Show help.

Default path: ~/.config/hypr/hypridle.conf.general keys include lock_cmd, unlock_cmd, before_sleep_cmd, after_sleep_cmd, ignore_dbus_inhibit, ignore_systemd_inhibit, ignore_wayland_inhibit, and inhibit_sleep (0 disable, 1 wait for beforesleepcmd, 2 auto, 3 wait until a lock screen holds the session).Each listener needs timeout (seconds). Optional on-timeout, on-resume, ignore_inhibit, condition_cmd (run before on-timeout; exit 0 to fire), and condition_retry (re-check every N seconds while still idle).

$ general {
    lock_cmd = pidof hyprlock || hyprlock
    before_sleep_cmd = loginctl lock-session
}

listener {
    timeout = 300
    on-timeout = loginctl lock-session
}

Needs a running Hyprland session and a valid config. Sleep inhibition depends on logind. Do not put blocking scripts in condition_cmd.

Part of the Hyprland ecosystem (hyprwm).

hyprlock(1), hyprland(1), hyprctl(1), swayidle(1)

Source code · Documentation