A cross-platform curses-based monitoring tool
Project Description
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.1.0)
- 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
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 library.
Glances < 1.7.2 only works in server mode. It will run in server mode automatically.
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://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
Documentation
For complete documentation see glances-doc.
License
LGPL. See COPYING for more details.
Release history Release notifications
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size & hash SHA256 hash help | File type | Python version | Upload date |
---|---|---|---|
Glances-1.7.2.tar.gz (1.2 MB) Copy SHA256 hash SHA256 | Source | None | Nov 1, 2013 |