wmmon(1)

💖 wmmon(1) — the manual, but make it cute 💖

okay bestie, welcome to the General Commands Manual for wmmon(1) — yes that's the manual name, we're keeping it, it's iconic 💅. sit down, grab a strawberry 🍓, and let's get you fluent in system monitoring.

---

✨ NAME ✨

wmmon — a Window Maker dockapp for monitoring system information 🦋

---

✨ SYNOPSIS ✨

wmmon [ OPTION ]

---

✨ DESCRIPTION ✨

so basically, WMMon watches your realtime CPU load AND your average system load in real time, and honestly? it comes with extra cute features too. it's meant to be docked in Window Maker, that's its whole main character era. 👑

here's what it's currently giving:

• a realtime CPU stress meter 🔥
• an auto-scaled average system load meter, like xload and wmavgload
• hint lines that change color as the system load goes up, lowkey a vibe check for your CPU
  • green for multiples of 1
  • yellow for multiples of 10
  • red for multiples of 100
• a realtime disk I/O stress meter 💾
• an auto-scaled disk I/O load meter
• realtime memory and swap usage meters 🧠
• a display for system uptime ⏱️
• three user-defined commands to launch, because you're a boss and you decide

---

✨ OPTIONS ✨

• -display display — tells it which X server to contact; go look at X(7x) for the deets
• -geometry geometry — sets the preferred position of the clock; again, X(7x) has you
• -l — locks the mode so it can't be cycled by clicking the upper-left widget. use this to open multiple copies of WMMon, each locked to a different mode. multitasking icon behavior fr 🔒
• -i — start in disk I/O mode, showing instantaneous disk usage and average disk load
• -b — include buffers and cache in memory usage calculations. ngl the trend in recent years has been to not include this in memory load monitors, but it can be useful info, so here's the option 🫶
• -s — start in system information mode, showing memory usage, swap usage, and uptime
• -h — show help information
• -v — print the version number

---

✨ USAGE ✨

you can cycle the WMMon display between CPU, disk I/O, and system information by clicking the upper-left widget. by default it shows CPU info. ✨

WMMon can also launch programs for you. click left, middle, or right mouse button in the average-load section of the window, and the pre-configured program for that mouse button gets launched. (scroll down to CONFIGURATION FILE, bestie, it's all there.)

and to move WMMon around? drag on the outer edges. those edges are not sensitive to mouse clicks, so don't come for them with your clicks, they will not respond. 🙈

---

✨ DOCKING IN WINDOW MANAGERS ✨

🌸 Window Maker

Window Maker girlies should drag and drop the WMMon window onto the Dock. then right-click the border of the window and pick “Settings...”. check “Start when Window Maker is started”. done, slay.

🌸 AfterStep

AfterStep users, put this exact line in your $HOME/.steprc:

Wharf wmmon - MaxSwallow "wmmon" wmmon &

🌸 Other window managers

WMMon runs nicely as a 64x64 shaped icon on your desktop. periodt.

---

✨ CONFIGURATION FILE ✨

WMMon can launch three user-defined commands, triggered by left, middle, and right mouse button clicks. define them in $HOME/.wmmonrc like this:

left: xterm
middle: xload
right: xcalc

if WMMon detects a $HOME/.wmmonrc file, it'll launch the appropriate command when you click on the clock. 💫

your system administrator can define default commands in /etc/wmmonrc. they may also choose to “fix” particular commands, making it impossible for users to change them. those live in /etc/wmmonrc.fixed — although ngl, this isn't a nice thing to do. 😭

---

✨ FILES ✨

• /etc/wmmonrc
• $HOME/.wmmonrc
• /etc/wmmonrc.fixed

---

✨ AUTHORS ✨

WMMon was written by Martijn Pieterse and Antoine Nulle. 👑

this manual page was written by Simon Law <sfllaw@debian.org> for the Debian system (but it may be used by others). it's based on the documentation provided by the original program.

this manual is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. 💖

---

okay that's the whole page, you ate that. go monitor something. 🌈

WMMON 1.0b2 🌸 May 1998 🌸 wmmon(1) — and that's the sign-off bestie, version 1.0b2, dated May 1998, and yes we're still calling it wmmon(1). mwah 💅💖