XOSVIEW

xosview is a program that gathers information from your operating system and displays it in graphical form. It provides a quick overview of how your system resources are being utilized.

It can be configured to be a small strip showing a couple of parameters on a desktop task bar, or it can display dozens of meters and rolling graphical charts across your entire screen.

Since xosview renders all graphics with core X11 drawing methods, you can run it on one machine and display it on another. If you can connect over a network, you can launch xosview remotely and monitor system activity.

This fork has been modified to show text on top of the meter bars similar to how IRIX old gr_osview did it. Here is a screenshot.

There is a new Xresource you must set for this to work properly.

xosview*topLabels:	True

---

Current Known Working Platforms

• Linux (tested on Fedora 27, but most distributions should work)
• GNU Hurd (Debian 2018-01-12)
• Solaris (tested on OpenIndiana Hipster 2018-01-12)
• NetBSD (7.1.1)
• FreeBSD (11.1)
• OpenBSD (6.2)
• DragonFly BSD (5.0.2)
• Cygwin (displays Windows stats)
• Minix (3.4.0rc6 dev snapshot)

---

Building xosview

Basic Steps

./autogen.sh
./configure
make
make install

Notes

• Run ./configure --help to see available options (e.g., install prefix).
• Requires a C++ compiler with C++14 support or newer.
• You can specify a compiler manually:

./configure CXX=path_to_your_compiler

• Optional libraries:
  • XPM (for background images)
  • Xft (for FreeType2 font support)

If these are missing, install the appropriate development packages using your system package manager.

• You can edit Makefile.config before building if you need to change defaults like optimization flags (rarely needed).
• Uses GNU make or BSD make. On systems like Solaris, you may need to install GNU make.

---

Installing xosview

Quick Install

make install

Details

• Follows GNU directory conventions: https://www.gnu.org/prep/standards/html_node/Directory-Variables.html

• Default install prefix: /usr/local

To change it:

./configure --prefix=/your/path

Preview install:

make -n install

Important Note

xosview hardcodes the app-defaults directory at compile time.

If you plan to change install paths later, set it during configure:

./configure --with-app-defaults=DIR

---

Running xosview

• After building, run:

xosview

• Help:

xosview --help

• View man page without installing:

zcat xosview.1 | groff -lascii -mandoc - | less -R

or

man ./xosview.1

---

Configuring xosview

• Uses default configuration for:
  • Meter colors
  • Fonts
  • Values
• Can be customized using X resources.

Recommended Method

Create a file:

~/.Xdefaults

xosview will read it even if your desktop environment does not.

• There are hundreds of configurable options (see man page).
• Example themes can be loaded using:

xosview -c <theme>

---

Stipple Support

For monochrome systems (e.g., NetBSD-mac68k):

• Enable stipple mode:

<!-- -->

enableStipple: true

• Uses fixed fill patterns:
  • 100%, 75%, 50%, 25%

---

Developer Information

See:

README.devel

for details about:

• Git
• Autoconf
• GCC
• Makefiles
• Internal architecture