pbs_idled(8B)
๐ค 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โ thepbs_idledcommand 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 thepbs_idledprocess. go go go ๐stopโ stops thepbs_idledprocess. okay bye ๐--versionโ thepbs_idledprocess 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
- nixos 26.05: openpbs 23.06.06-unstable-2026-04-02
- nixpkgs unstable: openpbs 23.06.06-unstable-2026-04-02
- Copyright (C) 1994-2021 Altair Engineering, Inc
- ๐ girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms