WMND(1)

💖 WMND — the WindowMaker network device monitor 💖

okay bestie, sit down, hydrate, because this is the manual page for WMND, from the General Commands Manual section 1 (yes, the one you'd type man wmnd for). it's a lil WindowMaker dock app and it's lowkey iconic. let's get into it 🫶

---

✨ NAME ✨

WMND — WindowMaker network device monitor. that's it, that's the name, periodt. 👑

---

🌸 SYNOPSIS 🌸

wmnd { options }

literally just run it with options. that's the whole vibe.

---

🦋 DESCRIPTION 🦋

so WMND is a WindowMaker dock application (yes, that WindowMaker, we love her) and here's what she serves you:

• a graph of your network traffic from the past few minutes 📈
• your current activity, live and in 4K
• your current send and receive rates
• your overall send and receive rates

and additionally — and this is the part that sends me — she can launch any program in response to mouse clicks. any program. the power. 💅

---

🎀 OPTIONS 🎀

every single one, no skips, we don't do that here:

• -i interface — pick the interface you wanna start with.
• -I interface — the interface(s) to monitor. defaults to all of them except lo and irda. under linux (using the linux_proc driver) you can list multiple interfaces separated by commas, which forces the offline ones and combines them all into a single instance. yes ma'am, multi-interface slay. 🔥
• -D driver — choose a driver to use. defaults to auto-probe.
• -l — start out using long device names.
• -m — start with the maximal values hidden 🙈.
• -t — start without displaying the connection time of ppp links.
• -M — use the maximal values of the entire history (not just the screen, iykyk).
• -w mode — pick the display mode you wanna start with. run wmnd -h for the list of available display modes. also, left-clicking on the graph cycles through all available modes, so go wild.
• -r rate — refresh rate, in microseconds.
• -s scroll — scroll rate, in tenths of seconds.
• -S steps — how many scroll steps to wait before updating the speed rate indicator.
• -b — scale the max and current rate values by factors of base 2 instead of the default 10-based scaling. (so 1K equals 1024 in binary mode, but 1000 in decimal mode. math girlies rise.)
• -c color — tx color.
• -C color — rx color.
• -L color — middle line color.
• -d display — draw onto the X11 display display.
• -f config — read config instead of ~/.wmndrc.
• -F — do not parse ~/.wmndrc.
• -h — show a summary of options.
• -v — show the version of WMND.
• -q — be less verbose (only displays errors).
• -Q — show informational messages.
• -o float — smoothing factor, a float from 0 to 1.
• -a bytes — use a fixed scale for the bytes modes, specified in bytes per second. by default it uses an automatic scale.
• -n name — change the WMND class/title name (defaults to "wmnd").

---

🌈 USAGE 🌈

💫 Active Interface

you can cycle through all available active interfaces in realtime, just left-click on the interface name gadget in the upperleft corner of WMND — or use the mouse wheel anywhere. anywhere, bestie. the whole app is a wheel target.

the lo interface is the exception to the rule: lo only works when you invoke it from the commandline, like wmnd -I lo. lo was mainly built in for testing purposes. she's a test girlie, she doesn't do parties. 😭

💫 Device Name

by default, WMND shows the device name short — four characters max. for example, ippp0 gets displayed as ipp0. right-click on it to toggle between short and long names. glow-up on demand. ✨

💫 Graphic Mode

left-click on the main graphic area to cycle the graphic mode. that's the whole thing. click away. 🖱️

💫 Max Meter

left-click to toggle between history max and screen max. (the max mode also affects the main graph scale, so it's not just cosmetic, she's got range.) the default is screen max when WMND starts up.

• right-click to hide or show.
• middle-click to zoom the statistics into a separated trend window.
• you can cycle the active interface, then middle-click again to monitor multiple interfaces concurrently. multitasking queen 👑

💫 Byte/Packet Mode

left-click on the letter gadget on the right-top corner to switch between Byte and Packet counter mode. "B" for byte, "p" for packet. and yes, the current mode affects the external trend window too — she's consistent like that. 💅

💫 User Script

click on the bottom rate meter to invoke the user command defined in the resource file .wmndrc. cute lil shortcut, no cap.

💫 Dragging WMND

okay listen, be sure to drag WMND on its outer edges — she's a bit picky, because of the large gfx pixmap she keeps. 🙈 alternatively, you can use a keyboard + mouse shortcut in your window manager (perhaps ALT+left-click) to drag her around. whatever works for your setup.

💫 Drivers

here's the roster, all of them:

• solaris_fpppd — Solaris/Linux ppp streams driver. gathers device data from /dev/ppp. uses code from the Solaris/Linux pppd server, and it should work wherever Solaris/Linux pppd works.
• linux_proc — reads data from the linux proc(5) virtual filesystem.
• freebsd_sysctl — uses the MIB to gather device statistics under FreeBSD. (offline devices handling is buggy, support needed! 😭)
• netbsd_ioctl — reads statistics through the NetBSD ioctl call.
• solaris_kstat — gathers all devices of class net from the kstat library.
• irix_pcp — reads metrics from the IRIX Performance Co-Pilot daemon. the interface format is:

[host@]interface

• generic_snmp — queries an IF-MIB capable snmp server to gather interface statistics. by default generic_snmp connects to localhost and uses the public community. you can change the community/host/interface to monitor by using the -I flag:

[community@]host[:interface]

you must specify an interface number, not an interface name. if the interface number is 0, or there's no interface specification, WMND will display all available interfaces. by default the community name is "public".

⚠️ beware: specifying an snmp v1 community name on a command line can be dangerous on a multiuser platform. please read the README file in the distribution for more details. fr fr, this one's not a drill. 🚨

• testing_dummy — this is the "last resort" driver. it shows a null device, useful only to make WMND not exit when all other drivers failed. can be enhanced to display something at compile time.

---

🍓 FILES 🍓

• ~/.wmndrc — user configuration.

the format of this file is described in the example file "wmndrc" that comes with the distribution (see /usr/share/doc/wmnd/). 📁

---

🧚 SIGNALS 🧚

• SIGTERM, SIGINT — clean WMND shutdown. she leaves the party politely. 🫶

---

💜 BUGS 💜

report bugs and suggestions to the current WMND maintainer: wave++ <wavexx@thregr.org>. more information (including usage instructions) can be found in the README file in the distribution — and these information should be integrated here too. (yes, the manpage is calling itself out. self-aware icon.)

---

⭐ SEE ALSO ⭐

X(3x), wmaker(1x), proc(5), trend(1)

go read those too, bestie, they're all part of the lore.

---

👑 AUTHOR 👑

this manual page was written by Arthur Korn <arthur@korn.ch>. the original WMND authour is Reed Lai, but it is currently maintained by Yuri D'Elia <wavexx@thregr.org>.

---

and that's a wrap on the WMND(1) page from the General Commands Manual, dated Apr 4, 2020 💖 go monitor some packets, you absolute legend. periodt. 🌸✨