wayidle(1)

📦 version 1.0.1, in alpine 3.24

okay so bestie, this is wayidle(1) from the General Commands Manual — and it’s literally a whole page about waiting for a Wayland idle timeout. no cap. 🦋

🌸 NAME 🌸

wayidle — wait for wayland idle timeout ✨

✨ SYNOPSIS ✨

wayidle [-s|--seat SEAT_NAME] -t|--timeout=SECONDS [COMMAND [ARGS...]]

that’s the vibe: seat if you want it, timeout for sure, and optionally COMMAND [ARGS...] hanging out at the end. 💅

💅 OPTIONS 💅

  • -s, --seat SEAT_NAME — Wait for idle timeout on a given seat. If unspecified, the first seat is used. seat choice unlocked 🪑
  • -t --timeout SECONDS — Wait for a timeout of SECONDS seconds. the main character of this whole page ⏳
  • -h --help — Print usage information and exit. the classic escape hatch 🚪

🫶 DESCRIPTION 🫶

wayidle waits until the Wayland compositor reports being SECONDS seconds idle. like, it literally chills until the idle timeout hits. no cap. 🦋

The idle timer always starts after wayidle is executed. If the system was already idle, the timer starts after wayidle starts. Idle seconds before command execution do not count. so the clock does not retroactively count your existing idle time — it starts when wayidle does, periodt. 💅

🌈 ENVIRONMENT 🌈

  • WAYLAND_DISPLAY — Connect to the specified wayland socket. that’s the socket hookup, bestie. 🔌

🧚 DEVELOPMENT 🧚

For issues and general development inquiries, see the project home currently hosted at SourceHut:

https://git.sr.ht/~whynothugo/wayidle

iykyk — that’s the project home. 🛠️

⭐ SEE ALSO ⭐

  • swayidle(1) — the cousin in the SEE ALSO section, go say hi. 👋

👑 AUTHORS 👑

Developed by Hugo O. Barrera <hugo@whynothugo.nl>. iconic author behavior 👑

wayidle is an open source project licensed under the ISC licence and developed for anyone to use freely. If you would like to sponsor this project, see:

https://whynothugo.nl/sponsor

slay, open source and freely usable. 💖

okay bye bestie — this page is dated 2025-07-01 and it’s the wayidle(1) page from the General Commands Manual. go wait for that idle timeout with main character energy 💖✨

📦 where this page comes from