WMFIRE(1)

📦 version 1.2.4, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 WMFIRE — bestie edition 💖

okay so you found wmfire(1) and honestly?? iconic. it lives in the General Commands Manual section, and it is literally a fiery dock app monitor. yes. fire. on your dock. watching your computer. slay.

✨ NAME ✨

wmfire — a fiery dock app monitor 🔥

🦋 SYNOPSIS 🦋

wmfire [-c CPU] [-f COLOUR] [-F FILE] [-g GEOMETRY] [-h] [-H MAX] [-i
INTERFACE] [-l] [-L MIN] [-m] [-n] [-p] [-s SPEED] [-x] [-y]

no cap, that's the whole vibe right there 💅

🌸 DESCRIPTION 🌸

so wmfire is a flaming dock app that can monitor your cpu, memory, network or a file. that's it. that's the whole personality and it ate.

  • Left click to change the status monitor (unless it's locked 🔒)
  • Middle click to hide/show nice'd process on cpu load
  • Right click to change flame colour (unless it's locked 🔒)
  • Mouse wheel up or down is the same as left click

okay now the fun part 🫶 — when your mouse hovers over it, the cursor disappears and gets replaced by a burning spot right at that location. two seconds later, symbols get burnt into the flame to show you what's being monitored:

  • for cpu, a short solid bar = average load, or a line of dots = the current cpu number on SMP systems
  • for memory, a grid of dots = a memory array 🍓
  • for network, a line of marching dots = data passing through a cable
  • for file values, you get a spinning disk platter 💿
(Not all window managers support all mouse over effects.) 😭

👑 OPTIONS 👑

one bullet per flag, no skipping, we respect all of them equally:

  • -c [0..3] — Monitor SMP CPU number X
  • -f [1..4] — Change flame colour. the menu is: 1:Natural, 2:Coronal, 3:Blue, 4:Green 🎨
  • -F [...] — Monitor file
  • -g [{+-}X{+-}Y] — Set initial window position
  • -h — Show help
  • -H [...] — Set maximum (high) value for file monitoring
  • -i [...] — Change the network interface. (Default is "ppp0")
  • -l — Lock flame colour and monitor 🔒
  • -L [...] — Set minimum (low) value for file monitoring
  • -m — Monitor the memory load
  • -n — Monitor the network traffic
  • -p — Fire effect only (no monitoring)
  • -r [...] — Change resource name (default: wmfire)
  • -s [...][K|M] — Change the network speed — kilobytes or megabytes. (Automatic preset values for interfaces: ppp=56K eth=100M)
  • -x — Exclude nice'd CPU load
  • -y — Set window sticky for window managers which do not support dock apps

🌈 EXAMPLES 🌈

here's one that goes so hard, copy it exactly bestie:

wmfire -F /tmp/file -L 40 -H 60 -i eth2 -s 1000M

💜 NOTES 💜

heads up: the file monitoring will only read the first value in a file. if you need complex parsing, use an external program to read the required value and write it to the same file wmfire is set to read. that's the assignment. 🫶

💀 BUGS 💀

found a bug? not you being a little detective 🔍 please report any bugs you may find to:

swanson@ukfsn.org

🎀 AUTHOR 🎀

Alan Swanson <alan.swanson@ukfsn.org>

http://www.swanson.ukfsn.org

and that's the whole page, periodt. this one comes from the General Commands Manual, dated June 2004, and it's WMFIRE(1) — shoutout to the original source and version for giving us a flaming dock app to obsess over. bye bestie, go watch your cpu burn 💖🔥✨

📦 where this page comes from