the-btfash-foundation/tmux-mem-cpu-load
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
CPU, RAM, and load monitor for use with tmux
12 Commits 1 Branch 23 Tags 477 KiB
C++ 74.4%
C 12.1%
CMake 6.5%
Shell 5.3%
Python 1.7%
dbd3f8e3c7
Go to file
Matt McCormick (thewtex) dbd3f8e3c7 Make cpu usage timing interval user option. 
Also convert sleep to microseconds so the delay time can always be less than the
tmux status bar update interval.
2010-02-25 08:54:18 -06:00
CMakeLists.txt rename screen-cpu-mem to tmux-mem-cpu-load 2010-02-24 18:04:41 -06:00
README.rst hardstatus spelling error fix 2009-09-11 01:19:56 -05:00
tmux-mem-cpu-load.cpp Make cpu usage timing interval user option. 2010-02-25 08:54:18 -06:00

README.rst 

====================================================
                  screen-cpu-mem
====================================================
----------------------------------------------------
CPU and RAM memory monitors for use with GNU Screen_
----------------------------------------------------



Description
===========


Two programs are provided for system monitoring in the *hardstatus* line of **GNU
Screen**: a CPU usage monitor and a memory usage monitor.  These programs are
intended to use minimal system resources.

The CPU usage monitor outputs a percent CPU usage over all processors that is
updated every second.  It also displays a textual bar graph of the current
percent usage where every '|' character represents 10% usage.  

The memory monitor is updated every three seconds and displays the used and
available memory.

Example::

  Mem:2885MB/7987MB  Cpu:[|||||     ]  51.2%



Installation
============


Dependencies
------------

Building
~~~~~~~~

* >= cmake_ -2.6
* C++ compiler (e.g. gcc/g++)


Download
--------

There are links to the source code at the `project homepage`_.


Build
-----

::

  cd <source dir>
  cmake .
  make


Install
-------

::

  su -
  make install
  logout



Configuring GNU Screen_
=======================


The ``$HOME/.screenrc`` file must be edited to make use of the installed
programs, ``screen-cpu-usage`` and ``screen-mem-usage``.

An example configuration::

  # backticks to display information in the statusbar
  backtick 1 0 0 /usr/local/bin/screen-mem-usage
  backtick 2 0 0 /usr/local/bin/screen-cpu-usage

  hardstatus alwayslastline  
  hardstatus string '%{kg}Host:%{kG}%H%{kg} %=%{kb}Mem:%{kB}%1`  %{ky}Cpu:%{kY}%2`%%  %{kR}Load:%{kr}%l%=%{kc} %D %m/%d %{kC}%C%a%{w}' 

The example configuration will result in::

  Host:flea   Mem:2961MB/7987MB  Cpu:[||        ]  25.6%  Load:0.64 0.35 0.28 Fri 09/11 12:56am




Author
======

Matt McCormick (thewtex) <matt@mmmccormick.com>


.. _screen: http://www.gnu.org/software/screen/
.. _cmake: http://www.cmake.org
.. _`project homepage`: http://github.com/thewtex/screen-cpu-mem