Glances an Eye on your system. A top/htop alternative for GNU/Linux, BSD, Mac OS and Windows operating systems.
Go to file
Nicolas Hennion d12a7305ae Merge pull request #267 from nicolargo/processfilter
Add monitored processes list
2013-07-31 06:56:38 -07:00
docs Update documentation for 1.7 2013-07-25 14:50:51 +02:00
glances No more monitored processes list in the default configuration file 2013-07-31 15:53:23 +02:00
i18n Add Chinese international 2013-07-31 15:32:39 +02:00
.gitignore Update .gitignore 2012-12-14 14:59:46 +01:00
.travis.yml Disable test against Travis-CI 2013-02-21 18:55:27 +01:00
AUTHORS Update author (add Jon Renner) 2013-03-23 21:38:19 +01:00
COPYING Strip leading/trailing whitespaces from all files 2012-06-19 13:00:00 +02:00
i18n-gen.sh Add Chinese international 2013-07-31 15:32:39 +02:00
MANIFEST.in Improve packaging - Round 2 2013-04-08 16:16:00 +02:00
NEWS On the road of the 1.7 version 2013-03-23 22:38:44 +01:00
README.rst Update README 2013-07-20 19:22:32 +02:00
requirements.txt Add psutil >= 1.0.0 support 2013-07-13 01:13:00 +02:00
setup.py Add batinfo to setup.py 2013-07-07 17:01:01 +02:00
TODO Improve packaging - Round 2 2013-04-08 16:16:00 +02:00
uninstall.sh Make uninstall script executable. 2013-05-24 00:36:11 +02:00

.. image:: https://api.flattr.com/button/flattr-badge-large.png
        :target: https://flattr.com/thing/484466/nicolargoglances-on-GitHub
.. image:: https://travis-ci.org/nicolargo/glances.png?branch=master
        :target: https://travis-ci.org/nicolargo/glances

===============================
Glances - An eye on your system
===============================

.. image:: https://raw.github.com/nicolargo/glances/master/docs/images/glances-white-256.png
        :width: 128

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

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

.. image:: https://raw.github.com/nicolargo/glances/master/docs/images/screenshot-wide.png

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
============

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

.. code-block:: console

    pip install Glances

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

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:

.. code-block:: console

    # pkg_add -r py27-glances

To install Glances from ports:

.. code-block:: console

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

OS X
----

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

Homebrew
````````

.. code-block:: console

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

If you get the following error:

.. code-block:: console

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

Try to run:

.. code-block:: console

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

MacPorts
````````

.. code-block:: console

    $ 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:

.. code-block:: console

    $ 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.

Puppet
------

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

Usage
=====

Just run:

.. code-block:: console

    $ glances

Documentation
=============

For complete documentation see `glances-doc`_.

Author
======

Nicolas Hennion (@nicolargo) <nicolas@nicolargo.com>

License
=======

LGPL. See ``COPYING`` for more details.


.. _psutil: https://code.google.com/p/psutil/
.. _PyPI: https://pypi.python.org/pypi
.. _pip: http://www.pip-installer.org/
.. _Homebrew: http://mxcl.github.com/homebrew/
.. _MacPorts: https://www.macports.org/
.. _glances-1.6.1-x86.exe: https://s3.amazonaws.com/glances/glances-1.6.1-x86.exe
.. _glances-1.6.1-x64.exe: https://s3.amazonaws.com/glances/glances-1.6.1-x64.exe
.. _Puppet: https://puppetlabs.com/puppet/what-is-puppet/
.. _glances-doc: https://github.com/nicolargo/glances/blob/master/docs/glances-doc.rst