jcrabtree / glances

Glances an Eye on your system

Follow Glances on Twitter: @nicolargo or @glances_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.5.1 (recommended version >= 1.2.1)
• setuptools

Optional dependencies:

• jinja2 (for HTML output)
• pysensors (for HW monitoring support) [Linux-only]
• hddtemp (for HDD temperature monitoring support)
• batinfo (for battery monitoring support) [Linux-only]

Installation

PyPI: The simple way

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

pip install Glances

To upgrade Glances to the latest version:

pip install --upgrade Glances

Linux

At the moment, packages exist for the following distributions:

• Arch Linux
• Debian (Testing/Sid)
• Fedora/CentOS/RHEL
• Gentoo
• Ubuntu (13.04+)
• Void Linux

So you should be able to install it using your favorite package manager.

FreeBSD

To install the binary package:

# pkg_add -r py27-glances

Using pkgng:

# pkg install 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 python
$ pip install Glances

MacPorts

$ sudo port install glances

Windows

Glances proposes a Windows client based on the colorconsole Python library. Glances version < 1.7.2 only works in server mode.

Thanks to Nicolas Bourges, a Windows installer is available:

• Glances-1.7.2-win32.msi (32-bit, MD5: dba4f6cc9f47b6806ffaeb665c093270)

Otherwise, you have to follow these steps:

• Install Python for Windows: http://www.python.org/getit/
• Install the psutil library: https://pypi.python.org/pypi?:action=display&name=psutil#downloads
• 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: Python headers are required to install psutil. For example, you need to install first:

• On Debian/Ubuntu, the python-dev package
• On CentOS/Fedora, the python-devel package (from the EPEL repository)
• On openSUSE/SLES/SLED, the python-devel package (from Oss repository)

Puppet

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

Usage

Just run:

$ glances

and RTFM, always.

Documentation

For complete documentation see glances-doc.

Author

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

License

LGPL. See COPYING for more details.