WMNUT(1)

📦
version 0.72 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ WMNUT — the Dockable UPS Monitor that's literally watching your power 💅

okay bestie, gather round, because this one is iconic: it's WMNUT, a Dockable UPS Monitor. yes, it's a whole little app whose entire main character job is to stare at your uninterruptible power supplies and tell you what's going on. 🫶

🌸 SYNOPSIS 🌸

wmnut [-A T1 T2] [-b BlinkRate] [-B BeepVolume] [-C CriticalLevel] [-d
display] [-h] [-l] [-L LowLevel] [-U upsname] [-v] [-V] [-w]

she takes options and she takes them gracefully. no positional args, no drama. periodt. 💅

💖 DESCRIPTION 💖

so. WMNUT is an UPS Monitor, and what that means is she visually displays and interprets the details of up to 9 UPSs' status through NUT — that's the Network UPS Tools framework, iykyk. 🔌✨

she's dockable when you're running WindowMaker or AfterStep window managers. but if you're on some other window manager? no worries bestie, just run her with the -w option and she'll show up as a cute, nicely-sized 64x64 application with a background. it's giving compact icon energy. 🎀

here's everything WMNUT serves you, no gatekeeping:

  • Status of power supply — that's the Blinking Red/Yellow/Green colored meter/battery 🔴🟡🟢
  • Percentage of battery remaining — both numeric and as a meter 📊
  • Load level percentage on output — numeric, if available (we don't invent data, we're not like that)
  • Runtime to empty — aka time left to battery depletion, formatted MM:SS ⏳
  • Communication status with UPS — the Blinking Red/Green "C" 💬

✨ OPTIONS ✨

  • -A <T1 T2> — sends messages to users' terminals when things get Low and critical. T1 is the seconds between messages when Low, and T2 is the seconds between messages when Critical. so like, the group-chat spam interval, but for power emergencies. 😭
  • -b <BlinkRate> — the blink rate for the red LED. set it to 0 for no blinking at all. (yes, 0 means chill.)
  • -B <Volume> — beep at Critical Level. Volume is between -100% to 100%. heads up though: this function has been disabled, at least temporarily. so she's not gonna sing for you rn, bestie. 🙈
  • -C <CriticalLevel> — defines the level at which the red LED turns on. 🔴
  • -d <display> — use an alternate display. multitasking queen.
  • -h — display the help screen. always read the help, babe.
  • -l — use a low-color pixmap to conserve colors on 8-bit displays. resourceful. we love a frugal icon. 💜
  • -L <LowLevel> — defines the level at which the yellow LED turns on. 🟡 important: CriticalLevel takes precedence if LowLevel<CriticalLevel. so critical really said "i'm the main character here."
  • -U <upsname> — define upsname, in the format [upsname@]hostname, default is localhost. you can use up to 9 calls to -U <upsname> to monitor multiple UPSs at once. polyamorous monitoring, we stan. 👑
  • -v — print version, and it includes important WMNUT info. not just a number, she's giving lore.
  • -V — Verbose mode: display NUT available feature and base value. for when you need the whole story. 🗣️
  • -w — Windowed mode. this is the opposite of native withdrawn mode for Window Maker. 🌈

💀 BUGS 💀

None are known.

that's right. she's flawless. not me being obsessed with a UPS monitor but here we are. 💅✨

🫶 AUTHOR 🫶

Arnaud Quette <arnaud.quette@free.fr>

Maintained since 2021 by the Network UPS Tools project. 👑

okay that's the whole page bestie!! this beauty comes from the General Commands Manual, dated 01 June 2012, and yeah she's literally WMNUT(1). go monitor those UPSs, you got this 🦋💖🎀

📦 where this page comes from