Linux

Where Is the hypridle Config File?

hypridle reads timeout listeners from a config file under the hypr config home on Linux. Path, syntax and lock hookup.

Last updated

hypridle is a small daemon with one config file beside the hypr tree. Listener blocks name idle seconds and the commands to run, commonly locking or suspending.

Compositors start it as a user service or from the hyprland config directly. That placement decides reload behavior. Editing the file without restarting the daemon leaves old timeouts running.

Where hypridle stores this, by platform

Linux
~/.config/hypr/hypridle.conf

Timeout listeners and resume commands in one file. Locking delegates to hyprlock while suspend and output actions run inline. Restart the daemon or user service after edits.

Frequently asked questions

How do I move hypridle settings?

Copy hypridle.conf to the same relative path on the new machine. Timeout listeners and resume commands travel with it. Locking itself stays delegated to hyprlock, so keep that pairing configured too.

Where do I set lock timeouts?

In hypridle.conf with listener blocks naming timeout seconds and on-timeout commands, plus on-resume counterparts. Each block pairs one idle delay with lock, suspend or output actions. Reload the user service after edits.

Notice an outdated path? Let us know.