Installation
============

Getan requires `urwid <http://excess.org/urwid>`_ in a version >= 1.0. Urwid is
a console user interface library written is python.

Install urwid
-------------

On Debian GNU/Linux >= Wheezy just run as root:::

    $ apt-get install python-urwid

On other systems urwid may be installed via pip or directly put into the sources
of getan.

Using pip
^^^^^^^^^

To install urwid via pip run as root::

    $ pip install urwid

Or if you prefer using a virtualenv::

    $ virtuelenv getan-env
    $ source getan-env/bin/activate
    (getan-env)$ pip install urwid

Using urwid sources
^^^^^^^^^^^^^^^^^^^

Urwid can be put as source to the getan directory when getan is run directly
from the sources. Urwid source can be downloaded from `pypi
<https://pypi.python.org/pypi/urwid/>`_ or from the `urwid website
<http://excess.org/urwid/>`_.

For urwid 1.1.1 the direct download link from pypi is
`<https://pypi.python.org/packages/source/u/urwid/urwid-1.1.1.tar.gz>`_ (md5sum
should be 932d199de6fc847eab2c151512220665).::

    $ cd getan-source
    $ wget https://pypi.python.org/packages/source/u/urwid/urwid-1.1.1.tar.gz
    $ md5sum urwid-1.1.1.tar.gz
    $ tar xzvf urwid-1.1.1.tar.gz
    $ ln -s urwid-1.1.1/urwid urwid

Install getan
-------------

A installation of getan is not required. It can also be run directly from the
sources. To install getan system wide the following command must be run as root
user::

    $ python setup.py install

Starting getan
==============

Getan can be directly run from sources or after a system wide installation from
the bin dir (e.g. /usr/bin).

Running from Sources
--------------------

To run getan from the sources run::

    $ ./getan.py

or::

    $ ./getan.py /path/to/mytime.db

to choose a different sqlite3 database the the defautl time.db

The classic version of 'getan' which is based on curses can be run with::

    $ classic/getan

or::

    $ classic/getan /path/to/mytime.db

Running from installation
-------------------------

After installing getan it can be run with::

    $ getan

or::

    $ getan /path/to/mytime.db

The classic version of 'getan' is also available::

    $ getan-classic

or::

    $ getan-classic /path/to/mytime.db