Skip to main content

Terminal based time-tracking and reporting tool; comparable to 'worklog'.

Project description

Usage

Call getan or getan.py in a terminal to start with an empty list of tasks that you want to track time for.

Use the Insert-Key to add a new task to track. (A task is called project within getan.)

Now select one of the projects with the arrow keys from your keyboard and press enter to start the clock. See INTRODUCTION for more keyboard commands.

The time log entries will be saved in an sqlite database, by default getan will create ~/.getan/time.db. The scripts/ will help to generate reports from them.

Customization

Use ~/.getan/getanrc or the system-wide /etc/getanrc to customize keys and colors. See getan/config.py for the recognized options. Example:

[keybindings]
# changes the insert function to be activated by the `)` key
insert: )

[theme]
header: light green, dark green
body: light green, black

Installation

Getan requires urwid in a version >= 1.0. Urwid is a console user interface library written in Python. For console output e.g. zeiterfassung.py Getan also requires Jinja2 <http://jinja.pocoo.org/>_.

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:

$ virtualenv getan-env
$ source getan-env/bin/activate
(getan-env)$ pip install -U pip  # to get the latest pip
(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.

For urwid 1.1.2 the direct download link from pypi is https://pypi-hypernode.com/packages/source/u/urwid/urwid-1.1.2.tar.gz (sha256sum is f56568b4f8459b3265c65d9e275ef72df6cb16ad0c291f0feb027cc911ea0f26).:

$ cd getan-source
$ v=urwid-1.1.2
$ curl -O https://pypi-hypernode.com/packages/source/u/urwid/$v.tar.gz
$ sha256sum $v.tar.gz
$ tar -xzvf $v.tar.gz
$ ln -s $v/urwid urwid

Install Jinja2

On Debian GNU/Linux just run as root::

$ apt-get install python-jinja2

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

Using pip

To install jinja2 via pip run as root:

$ pip install jinja2

Or if you prefer using a virtualenv:

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

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 then the default 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

CREDITS

Getan is Free Software licensed under the terms of GPLv3 or later. For details see LICENSE coming with the source of ‘getan’.

Main development

2014-(current maintainer) Bernhard E. Reiter <bernhard@intevation.de> 2011-2014 Björn Ricks <bjoern.ricks@intevation.de> 2010 Ingo Weinzierl <ingo.weinzierl@intevation.de> 2009-2014 Thomas Arendsen Hein <thomas@intevation.de> 2008-2010 Sascha L. Teichmann <sascha.teichmann@intevation.de>

Contributions

Stephan Holl Tom Gottfried

Thanks

To all users that gave feedback, especially at Intevation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getan-2.1.tar.gz (30.5 kB view details)

Uploaded Source

Built Distribution

getan-2.1-py2-none-any.whl (41.3 kB view details)

Uploaded Python 2

File details

Details for the file getan-2.1.tar.gz.

File metadata

  • Download URL: getan-2.1.tar.gz
  • Upload date:
  • Size: 30.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for getan-2.1.tar.gz
Algorithm Hash digest
SHA256 29e65cf3cfe4da78c56ad19302968034c8707c18901d8b132a8fc9c81d8b124f
MD5 db6f43393ab242a5fb8c3769c76f9a5e
BLAKE2b-256 818a5373001ff9f3156a89e9510e3bf2a541fd6540776edc0d70ab7cb6c93f6f

See more details on using hashes here.

File details

Details for the file getan-2.1-py2-none-any.whl.

File metadata

File hashes

Hashes for getan-2.1-py2-none-any.whl
Algorithm Hash digest
SHA256 858babe1d5bd62cd2e0670723f8c9fdc0aa67bd4725641b1bb4bf7df99ef1109
MD5 3e6ef3a1e5a65e15e6d902e0314b6abd
BLAKE2b-256 3f7afed687bf3610600b399f327b95309dc334382321a660cbb2e88a8e29d4b7

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page