PROCMETER3(1)

📦 version 3.6+svn415, in debian bookworm, debian trixie, opensuse-leap 16.0, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 PROCMETER3 — the procmeter3 manual page, bestie edition 💖

okay so welcome to PROCMETER3(1), aka the General Commands Manual entry for the one and only ProcMeter3. this is the glow-up version, no cap. 🫶

✨ NAME ✨

procmeter3, procmeter3-xaw — a user friendly system monitoring program. literally she watches your system so you don't have to. 👑

🌸 SYNOPSIS 🌸

procmeter3|procmeter3-xaw [-w <hint1>[,<hint2>]] [-h|--help]
[--rc=<filename>] [--...]  [...]  [X  windows  options]

🦋 DESCRIPTION 🦋

ProcMeter displays one or more pieces of information about the operating system and other resources. it's giving dashboard but make it cute. ✨

most of the info she shows you comes straight from the /proc filesystem. the program is modular and very configurable, which is basically the technical way of saying she's flexible and she ate. 💅

💜 OPTIONS 💜

the command line options are described below, and yes, we're going through all of them, bestie. no skipping. 🎀

  • -h — provides a help message listing the available outputs. this will be different for different computers depending on the Linux kernel version that is being used and the hardware/software that is configured. so like, your -h and your friend's -h are not the same -h, and that's iconic actually. 🌈
  • -w — gives Extended Window Manager hints (EWMH) to change the way that the Window Manager treats the ProcMeter3 window. implemented hints are: above, below, skip_pager, skip_taskbar, sticky.

you can give more than one hint separated by commas (e. g. -w above,skip_taskbar,sticky), or use -w multiple times (e. g. -w above -w sticky). two ways to serve the same look, we love options. 🍓

  • --rc=<filename> — load the specified .procmeterrc file in stead of the searching in the usual places. when you want a specific config, not whatever the usual places are serving. 🙈
  • --... — a list of configuration file options that will override the values in the .procmeterrc file. the format of these options is (for example) --resources.background=grey50 which is equivalent to the entry in the .procmeterrc file of
[resources]
background = grey50

all spaces around the equal sign must be removed and if spaces are required in the value on the right hand side then quotes must be used around the entire command line option. read that twice, bestie, the spacing rules are strict and she WILL notice. 💀

  • ... — a list of names of outputs that are to be displayed. this can include any of the outputs that are available (see the -h option). for the CPU usage is in a module named Statistics with an output named CPU and there are graph (-g), text (-t) and bar (-b) options. to display the CPU usage graph you would use the command line option Statistics.CPU-g. see how the naming works? module dot output dash type. periodt. ✨
  • X windows options — the standard set of X Windows program options, see X(1) for information. these include -geometry to set the size of the window, -display to set the display and other general X window options. the classics never miss. 👑

🎀 USAGE 🎀

when started the program will display all of the requested information in a set of output panels (vertically aligned by default). each output can be either a graph, text or bar, and can have a label indicating what it represents. the outputs that are displayed are those from the command line and those from the .procmeterrc configuration file. both sources, working together, main character energy. 💫

🖱️ left mouse button — the options menu

the left mouse button will produce a menu of options that are specific to the output that is selected.

  • the Properties option on this menu will give more detailed information about the origin and meaning of the information that is displayed. when the properties information window is displayed, clicking on another output will change the displayed information. so you can just keep clicking and the info keeps updating. obsessed. 😭
  • the Move to Above and Move to Below options allow the output to be moved around in the window. selecting one of these options will change the mouse cursor to a hand, use this to select another output. the output that was selected first will be moved to above or below the output that was selected second. order matters here, fr fr. 🫶
  • the Run option on the menu (which may not be available on all outputs) will run the specified command. this may be to display a list of running processes, show the amount of free memory or disk space for example. this menu option is configurable in the .procmeterrc file.

🖱️ right mouse button — the module menu

the right mouse button will produce a set of menus that list the modules that are available and for each of them the available set of outputs.

there are three types of output, text and two graphical outputs, these are indicated in the sub-menus by icons. 👑⭐🎀

selecting one of the outputs from a sub-menu will cause that output to be displayed if it is not already visible. if it is currently displayed then it will be disabled. those that are currently displayed are indicated by a marker to the left in the sub-menu. when the output is added to the window it will be placed at the bottom, use the left mouse button to move it if required. yes you can move it, go wild. 💅

🖱️ middle mouse button

the middle mouse button will display the sub-menu that is associated with the module for the output that is selected. this is one of sub-menus that are found with the right mouse button. lowkey a shortcut, highkey a vibe. ✨

🌈 MODULES 🌈

the modules that are available for procmeter3 and procmeter3-xaw are described in the procmeter3_modules(1) manual page. go read that one next, bestie, she's got the lore. 📖

💜 X RESOURCES 💜

as with all X Window programs X resources can be used. for this version of ProcMeter (compared to previous versions) this is not the default method of configuring the program. the file $HOME/.procmeterrc contains the configuration information. so like, X resources are still valid, they're just not the default anymore — the rc file is the moment. 🎀

🔥 SEE ALSO 🔥

X(1) procmeterrc(5) procmeter3_modules(1)

👑 AUTHOR 👑

Andrew M. Bishop 1998-2008

and that's the whole page, bestie — slay, no cap, you now understand PROCMETER3(1) fr fr 💖

this has been the General Commands Manual for ProcMeter3, dated July 3, 2010. thank you for coming to my ted talk, mwah 🫶✨

📦 where this page comes from