jrenner / glances

Glances an Eye on your system

Glances - An eye on your system

Glances is a cross-platform curses-based monitoring tool written in Python.

It uses the psutil library to get information from your system.

Requirements

• python >= 2.6 (tested with version 2.6, 2.7, 3.2, 3.3)
• psutil >= 0.4.1 (recommended version >= 0.6)
• jinja (optional for HTML output)
• pysensors (optional for HW monitoring support)
• hddtemp (optional for HDD temperature monitoring support)
• setuptools

Installation

Actually, Glances is available for Arch Linux, Fedora / CentOS / RHEL, Debian (Sid/Testing), Ubuntu (13.04+) and FreeBSD, so you should be able to install it using your favorite package manager.

Glances is on PyPI. To install, simply use pip:

pip install Glances

OS X

OS X users can also install Glances using Homebrew or MacPorts.

Homebrew

$ brew install brew-pip
$ export PYTHONPATH=$(brew --prefix)/lib/python2.7/site-packages
$ brew pip Glances

Note

If you get the following error:

Error: Failed executing: pip install glances==X.X --install-option=--prefix=/usr/local/XXX/glances/X.X (.rb:)

Try to run:

$ pip install glances==X.X --install-option=--prefix=/usr/local/XXX/glances/X.X
$ brew link Glances

MacPorts

$ sudo port install glances

Windows

Windows only support Glances in server mode. Glances will automatically run in server mode on it.

Thanks to Nicolas Bourges, Glances can be easily installed using a Windows installer:

• glances-1.6.0-x86.exe (32-bit, md5sum: 1d25902a2b1030f953a108792f4732cf)
• glances-1.6.0-x64.exe (64-bit, md5sum: de2c35c4bdd6a3ab2b938ea5f4c1567d)

Otherwise, you have to follow these steps:

• Install Python for Windows: http://www.python.org/getit/
• Install the psutil library: https://code.google.com/p/psutil/downloads/list
• Download Glances from here: http://nicolargo.github.io/glances/

Source

To install Glances from source:

$ curl -L https://github.com/nicolargo/glances/archive/vX.X.tar.gz -o glances-X.X.tar.gz
$ tar -zxvf glances-*.tar.gz
$ cd glances-*
# python setup.py install

Note

On Debian/Ubuntu, you have to install first build-essential and python-dev.

Puppet

You can install Glances using Puppet: https://github.com/rverchere/puppet-glances

Usage

Just run:

$ glances

Documentation

For complete documentation see glances-doc.

Author

Nicolas Hennion (@nicolargo) <[e-mail]>

License

LGPL. See COPYING for more details.