PSI-NOTIFY(1)

✨ PSI-NOTIFY ✨

okay bestie, welcome to psi-notify — she's a manual page from the General Commands Manual (section 1, the iconic section), and she is so much simpler than she sounds. let's get into it 💅

🌸 NAME 🌸

psi-notify — notify on system-wide resource pressure using PSI

🦋 DESCRIPTION 🦋

so basically psi-notify is a minimal, unprivileged notifier for system-wide resource pressure using PSI. yes, unprivileged — she does not need root, she does not need you to fight with sudo, she just vibes 💖

what's the point? she helps you spot misbehaving applications on your machine before they start to severely impact system responsiveness. and the way she does it is literally something that MemAvailable, CPU graphs, I/O utilisation graphs and other metrics cannot do. not to be dramatic but it's giving main character energy 👑

🎀 OPTIONS 🎀

lowkey the funniest part. psi-notify does not take any options. periodt.

if any are provided, a help message will be printed and psi-notify will exit. that's it. that's the whole section. she's an icon, she's a legend, and she's not taking your flags 🙈

🍓 CONFIGURATION 🍓

you can optionally put configuration in ~/.config/psi-notify. here's an example that will check roughly every 5 seconds, and pop up a notification when the configured values are exceeded:

update 5
log_pressures false

threshold cpu some avg10 50.00
threshold memory some avg10 10.00
threshold io full avg10 15.00

and here's the thing bestie — these are the default settings if no configuration is provided. so if you do nothing at all, this is exactly what you're running. no cap 🫶

for more information about how these values are calculated, please see the PSI documentation at https://facebookmicrosites.github.io/psi/.

🧚 DEPENDENCIES 🧚

before you get attached, she has needs. and they're not negotiable:

• psi-notify requires Linux kernel 4.20+ and CONFIG_PSI=y. like, both of them. not optional. 💀
• you will also need a notification daemon that conforms to the Desktop Notifications specification to receive the notifications — without one she's just out here yelling into the void 😭

🌈 SEE ALSO 🌈

• cgroups(8)
• proc(5)

go read them, they're part of the lore ✨

💜 AUTHOR 💜

Chris Down chris@chrisdown.name — the actual legend behind all of this 🌟

⭐ REPORTING BUGS ⭐

found something cursed? please send bug reports to https://github.com/cdown/psi-notify/issues. she wants to know. we all want to know. 💅

ngl, that's the whole page. short, sweet, does exactly one thing and ate while doing it. obsessed. 🔥

okay bye bestie, this was PSI-NOTIFY(1) from the General Commands Manual — mwah, go pressure-check your system 💖🦋🎀