WMTOP(1)

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

💅 WMTOP(1) — the WindowMaker dockapp glow-up

okay bestie, settle in, because we're talking about wmtop — it's a WindowMaker dockapp and it is genuinely that girl. manual name? WMTOP(1), user manual, and yes this is the whole thing, no skimming. 🫶

✨ SYNOPSIS ✨

wmtop [-c command] [-U] [-x regexp] [-m]

that's the whole vibe up front. now let's get into it. 🌸

🦋 DESCRIPTION 🦋

so wmtop shows you the CPU — or the physical memory usage, but heads up, that's under Linux only — of the top three processes. three. that's it. it's giving main character energy, not an ensemble cast. 💅

and you can refine which processes show up using criteria you supply yourself — either by passing stuff at the command line, or by just clicking on the application. your choice, no cap. ✨

💖 OPTIONS 💖

first, the mouse lore, because the clicking is part of the interface, fr fr:

  • left click — alternates between CPU and memory display 🔄
  • right click — launches the application you specified at the command line 🚀
  • middle click — switches between displaying all processes and user only processes 🎀

now the flags, one by one, no skipping, we don't do that here:

  • -v — displays the program version. short, sweet, iconic. 👑
  • -geometry — the standard X geometry specifications. but listen: only the X and Y position requests are honoured. any height and width specifications will be ignored. periodt. so don't come crying to me when your size request does nothing. 💀
  • -display — specify an X server other than the local display. running somewhere else? say so here. 🌈
  • -U — displays processes only owned by the user. just yours, bestie, nobody else's. 🫶
  • -c command — execute command when the application is right clicked. this is the one your mouse is waiting for. ✨
  • -x regexp — exclude processes whose name matches the given regular expression. and lowkey the regex is chill: it need only match part of the process name. use '^' to mean the start of the name and '$' to mean the end. so like, partial matches are fine, it's not strict like that. 😌
  • -m — show memory usage rather than CPU usage on start-up. first impressions matter. 💅
  • -a theme — choose an artistic style or theme for wmtop to use. yes it's a whole aesthetic moment. 🎀
  • -s — set interval between process samples in milliseconds. ⏱️
  • -r — set interval between screen updates in milliseconds. ⏱️
ngl, -s and -r are two different clocks — sampling and updating — so don't conflate them, bestie. both in milliseconds, both yours to tune. 🧚

🌟 EXAMPLES 🌟

monitor only user processes, exclude WindowMaker dock apps, and pop up xps when double clicked:

wmtop -c xps -U -x '^wm'

and where does that '^wm' come from? we're assuming all the dock apps have names starting with 'wm'. iykyk. 🦋

😭 BUGS 😭

found a bug? not me manifesting that, but if you did — please report any bugs you may find to:

wmtop-bugs@tanelorn.demon.co.uk

they wanna hear it, fr fr. 🙈

👑 AUTHOR 👑

Dan Piponi <dan@tanelorn.demon.co.uk>

http://www.tanelorn.demon.co.uk

http://wmtop.sourceforge.net

🎀 SEE ALSO 🎀

top(1)

okay that's the whole page, you ate it, you understood it, and honestly? slay. this little dockapp hails from Linux, dated JUNE 1999, and it's still WMTOP(1) at heart. mwah. 💖✨🌸

📦 where this page comes from