pbs_idled(8B)

๐Ÿ“ฆ version 23.06.06-unstable-2026-04, in nixos 26.05, nixpkgs unstable

๐Ÿ’ค pbs_idled(8B) โ€” the little daemon that knows when you're actually at your desk ๐Ÿ’ค

okay so real talk: this is the man page for pbs_idled, and it lives in section 8B of the manual, which is the PBS Professional corner of the world. it's a whole daemon whose entire personality is "are you touching the keyboard or not" and honestly? iconic. let's get into it ๐Ÿซถ


โœจ NAME โœจ

pbs_idled โ€” runs the PBS daemon that watches the console and tells pbs_mom all about your idle time. yes, it's literally the vibes-checker for whether a machine is busy or just sitting there. ๐Ÿ’…


๐Ÿง LINUX SYNOPSIS ๐Ÿง

pbs_idled [-D <display>] [-r <reconnect delay>] [-w <wait time>]
pbs_idled --version

๐ŸชŸ WINDOWS SYNOPSIS ๐ŸชŸ

pbs_idled [start | stop]
pbs_idled --version

๐Ÿ’– LINUX DESCRIPTION ๐Ÿ’–

so on Linux, pbs_idled is out here monitoring an X windows display and reporting the display's idle time back to PBS. if the mouse moves or a key gets touched, PBS gets told that the vnode is busy. no cap, that's the whole job. ๐ŸญโŒจ๏ธ

the way you're supposed to run this: from the system-wide Xsession file, in the background, before the window manager is run. main character placement, honestly.

๐Ÿšจ important bestie: if you run this program outside of the Xsession, it will need to be able to make a connection to the X display. if it can't connect, it can't do its little job.

for the deets on X security, go peek at the xhost or xauth man pages. iykyk. ๐Ÿ”


๐ŸชŸ WINDOWS DESCRIPTION ๐ŸชŸ

on Windows the plot shifts a little: pbs_idled reads its polling interval from a file called idle_poll_time, which is created by MoM. then it monitors keyboard, mouse, and console activity, and updates a file called idle_touch whenever it catches user activity. also created by MoM. team work makes the dream work fr fr. ๐Ÿงš


๐ŸŒธ LINUX OPTIONS ๐ŸŒธ

  • -D <display> โ€” the display to connect to and monitor. point it at the X display you want it to keep an eye on. ๐Ÿ‘€
  • -r <reconnect delay> โ€” time to wait before we try to reconnect to the X display if the previous attempt was unsuccessful. basically the "okay bestie, take a breather, try again" timer. ๐Ÿ˜ฎโ€๐Ÿ’จ
  • -w <wait time> โ€” interval between times when the daemon checks for events or pointer movement. the snooze button between vibe checks. โฑ๏ธ
  • --version โ€” the pbs_idled command returns its PBS version information and exits. โœจ this option can only be used alone โœจ โ€” do not try to pair it with friends, it's a solo act.

๐Ÿฆ‹ WINDOWS OPTIONS ๐Ÿฆ‹

  • start โ€” starts the pbs_idled process. go go go ๐Ÿš€
  • stop โ€” stops the pbs_idled process. okay bye ๐Ÿ‘‹
  • --version โ€” the pbs_idled process returns its PBS version information and exits. again: this option can only be used alone. it's giving independent woman energy. ๐Ÿ’…

๐Ÿ‘‘ SEE ALSO ๐Ÿ‘‘

pbs_mom(8B), xhost(1), xauth(1) โ€” go read those too, they're the supporting cast and they ate. ๐ŸŒˆ


and that's the whole page bestie, you understood it perfectly, i'm so proud of you ๐Ÿ’œ

source/version: Local ยท date: 6 May 2020 ยท and it's all part of PBS Professional, mwah ๐ŸŽ€โœจ

๐Ÿ“ฆ where this page comes from