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) [Linux-only]
• hddtemp (optional for HDD temperature monitoring support)
• batinfo (optional for battery monitoring support) [Linux-only]
• setuptools

Installation

PyPI: The simple way

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

pip install Glances

Note:

On Debian/Ubuntu, you need to install first the python-dev package.

On CentOS/Fedora, you need to install first the python-devel package (from the EPEL repository).

To upgrade Glances to the latest version:

pip install --upgrade Glances

Linux

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

FreeBSD

To install the precompiled binary package:

# pkg_add -r py27-glances

To install Glances from ports:

# cd /usr/ports/sysutils/py-glances/
# make install clean

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

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

Glances 1.7.2 proposes a Windows client based on the colorconsole Python librairy.

Version < 1.7.2 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.1-x86.exe (32-bit, md5sum: 13d5be664599f80152f8f1ae47400576)
• glances-1.6.1-x64.exe (64-bit, md5sum: a347ec5097d6d4d5039c7233872757a8)

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
• Install the colorconsole library: http://code.google.com/p/colorconsole/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 need to install first the python-dev package.

On CentOS/Fedora, you need to install first the python-devel package (from the EPEL repository).

On openSUSE/SLES/SLED, you need to install first the python-devel package. (from Oss repository).

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) <[email protected]>

License

LGPL. See COPYING for more details.