GCPUBAR(1)

πŸ’– GCPUBAR(1) β€” the graphical CPU usage meter, bestie edition πŸ’–

okay so welcome to the General Commands Manual entry for GCPUBAR(1), which is genuinely one of my faves because it's tiny and it slays. sit down, grab a strawberry πŸ“, and let's get into it.


✨ NAME ✨

dzen2-gcpubar β€” a graphical CPU usage meter. she's little, she's pretty, she tells you how hard your CPU is working. main character energy fr fr πŸ‘‘


🌸 SYNOPSIS 🌸

dzen2-gcpubar [-i interval] [-c count] [-fg color] [-bg color] [-w pixel] [-h pixel] [-nonl]

that's the whole vibe. a command and a lil pile of optional flags. no cap. πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

gcpubar is a CPU utilization meter for Linux. it's not out here doing anything shady β€” it just relies on the existence of the /proc/stat file and generates fully graphical meters that you can view with dzen.

so basically: your kernel keeps receipts in /proc/stat, and this lil icon reads them and turns them into a bar you can actually look at. iconic behavior honestly 😭✨


πŸ’… OPTIONS πŸ’…

A summary of options is included below. (this is the whole list, we are NOT skipping any of them, every single one gets its moment 🌈)

  • -i β€” Update interval in seconds (default 1). and yes bestie, you can use positive values less than 1 for intervals shorter than 1 second. so if you want that zippy sub-second refresh, she's got you πŸƒβ€β™€οΈπŸ’¨
  • -c β€” Terminate after displaying argument to this option (default infinite). so you hand her a number and she counts down to her own exit. default is literally never stopping. eternal. infinite. the way that she just keeps going 🫢
  • -fg β€” Foreground color πŸŽ€
  • -bg β€” Background color πŸŽ€
  • -w β€” Width in piwels. (yes. piwels. that's what the page says. i am not fixing it, i am not touching it, it's canon now πŸ’€ keep it in your heart)
  • -h β€” Height in pixels πŸ“
  • -nonl β€” No new line, don't put '\n' at the end of the bar (default: do print '\n'). so by default she's polite and adds that newline; with -nonl she's like "no, i'm good, no trailing newline for me" πŸ™ˆ
heads up bestie: that -w one really does say piwels in the manual. i'm just the messenger 🧚

πŸ‘‘ AUTHOR πŸ‘‘

gcpubar was written by Robert Manea. 🫑

This manual page was written by bertagaz <bertagaz@ptitcanardnoir.org>, for the Debian project (but may be used by others). so generous, so kind, we love a permissive queen πŸ’–


πŸ”₯ SEE ALSO πŸ”₯


and that's the whole page!! go forth, pipe a CPU bar into dzen, live your truth 🌈⭐

cute lil sign-off: this page is from the General Commands Manual, dated Jan 01 2008, and it's the GCPUBAR(1) entry β€” so if you ever forget, just remember: 2008 called, and it wanted you to know your CPU usage. mwah πŸ’‹πŸ’…βœ¨