HYPRIDLE(1)

📦 version 0.1.8, in ubuntu resolute, ubuntu stonking

💤 HYPRIDLE(1) — the manual page, but make it cute

okay bestie, welcome to hypridle(1) ✨ the idle daemon for Hyprland that literally just sits there vibing until you stop touching your keyboard, and then it does its little tasks. she's low maintenance, she's efficient, she's the main character of your login session 💅

🌸 NAME 🌸

hypridle — Idle daemon for Hyprland. that's it. that's the whole name. iconic.

✨ SYNOPSIS ✨

hypridle [-c config_path] [-q|--quiet] [-v|--verbose]

short, sweet, slays every time 🫶

💖 DESCRIPTION 💖

hypridle is a lightweight and efficient Wayland idle daemon, designed specifically for the Hyprland compositor. no bloat, no drama, just vibes 🌈

she implements the ext-idle-notify-v1 protocol, and on top of that she supports:

  • DBus loginctl lock/unlock and before-sleep hooks 🎀
  • the DBus inhibit interface (the thing Firefox, Steam, etc. use to say "bestie do NOT let the screen go dark rn") 🔥

🦋 USAGE 🦋

fr fr, hypridle should ideally be launched automatically after login. like, don't make her wait around in a terminal — let your compositor or systemd start her for you. both are valid, both are cute.

To launch from Hyprland, drop this line into your hyprland.conf:

exec-once = hypridle

To run hypridle using systemd:

systemctl --user enable --now hypridle.service

and that's it, she's alive 💜

🎀 OPTIONS 🎀

  • -c, --config config_path — point her at a different configuration file. if you don't, she defaults to: ${XDG_CONFIG_HOME}/hypr/hypridle.conf
  • -q, --quiet — suppress output. she goes silent mode, no yapping 🙈
  • -v, --verbose — enable verbose output for debugging. perfect for when something is acting up and you need her to tell you everything 👑

👑 AUTHOR 👑

Maintained by Carl Keinath <carl.keinath@gmail.com> 💌

🌈 SEE ALSO 🌈

hyprland(1), systemd(1)

go read those too, iykyk 🧚

MIT License. See the project repository for more information.

okay that's the whole page bestie, you ate that 💖 this was hypridle from July 2025, and yes, the HYPRIDLE(1) energy is immaculate. periodt. ⭐

📦 where this page comes from