PEMMICAN-MON(1)

📦
version 1.0.3 · 3 versions
, in ubuntu resolute, ubuntu stonking

💖 PEMMICAN-MON — pemmican manual, section 1 💖

okay bestie, sit down, hydrate, and let me tell you about pemmican-mon ✨ it's the manual page for section 1 of the pemmican docs, and it's literally just here to watch your PMIC notifications at runtime. no cap. 🫶

🌸 NAME 🌸

pemmican-mon — pemmican-mon — monitor PMIC notifications at runtime 👀

✨ SYNOPSIS ✨

usage: pemmican-mon [-h] [--help-all] [--help-gapplication]
                    [--gapplication-service]

like yes, that's the whole vibe check, four flags, we move 💅

🎀 OPTIONS 🎀

  • -h, --help — shows you the help message, then dips. that's it, that's the whole job 🌈
  • --help-all — shows you all the available help options, then exits. the full lore drop 📚
  • --help-gapplication — shows help options that are specific to GLib.Application, then exits. very niche, very GLib-coded 🧚
  • --gapplication-service — runs the application in GApplication service mode, which is what you want for DBus service files 🔥

💜 USAGE 💜

okay so here's the tea 🍓: pemmican-mon is meant to be a background service. like, it gets launched as a user-slice systemd service by the "graphical-session" target. that's its whole main character energy. 👑

what does it actually do? it monitors udev for power supply related events, and then reports the juicy ones via the freedesktop notification service. here's the link, it's literally in the original so here it is verbatim: <https://specifications.freedesktop.org/notification-spec/latest/> ✨

Power supply undervolt is like, typically reported when the supply drops below 4.8V, and ngl that's probably the most important event the app warns you about. it's the one you should care about fr fr 😭

If you wanna suppress this warning for your user, just touch the file ~/.config/pemmican/undervolt.inhibit. If you wanna suppress it system-wide (bold move bestie), touch the file /etc/xdg/pemmican/undervolt.inhibit.

⚠️ Warning: It is strongly recommended that any such notice is heeded, as brownout is very likely to lead to any manner of other (hard to predict or replicate) issues up to and including data corruption. Put simply, suppressing this warning is probably a very bad idea! 💀

fr, do not do it. i'm not being dramatic, the manpage is being dramatic and i'm just matching its energy. 🙈

USB over-current is the other event the app will warn about. this one happens when peripherals attached to the USB ports try to draw more current than permitted. and if the Pi 5 is being supplied by a PSU that did not negotiate a 5A feed at boot time, then the USB ports will be limited in their supply, and this warning is more likely. that's just the physics of it, i don't make the rules ⚡

If you wish to suppress this warning for your individual user, touch the file ~/.config/pemmican/overcurrent.inhibit. To suppress this warning system-wide, touch /etc/xdg/pemmican/overcurrent.inhibit.

🦋 ENVIRONMENT 🦋

so here's the thing — the notifications this application generates are capable of launching a web-browser (via the "More Information" action), which is iconic of them, but it means the script will also bail with an error in the event that DISPLAY or WAYLAND_DISPLAY are not found in the environment at startup. 🌈

like, no display, no browser, no vibes. it just errors out. iykyk 💅

👑 SEE ALSO 👑

💀 BUGS 💀

Please report bugs at: <https://github.com/waveform80/pemmican/issues> — the maintainers actually want to know, bestie, don't suffer in silence 🫶

🌸 Author 🌸

Dave Jones 👑

2023-2026 Dave Jones 🩷

and that's a wrap!! this was pemmican-mon from version 1.0.3, dated Feb 02, 2026 — yes that's the source line and the date, i promised i'd mention them and i keep my promises 💖 go touch some inhibit files (or literally don't) and stay charged, babe. periodt. ✨💅🎀

📦 where this page comes from