iapilgrim / 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) [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

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.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
• 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).

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.