Skip to main content

time tracker.

Project description

A time tracker.

The basic idea is to store all situation changes as a stream of events and create a report as an aggregation out of these.


  --help  Show this message and exit.
  add     Lazy apply tags and notes.
  break   Change to or start the `break` situation.
  remove  Lazy remove tags and flush notes.
  work    Change to or start the `work` situation.

Example session

You may add a timestamp, as in the example, which is parsed for your timezone. You may abbreviate the commands, so the shortes way to track your time of a running project is just z w and z b.

> z foobar work -t foo "2018-04-01 08:00:00"

> z break "2018-04-01 12:00:00"

> z w "2018-04-01 13:00:00"

> z b "2018-04-01 17:30:00"

> z
Store used: /home/olli/.config/zeitig/olli
Groups created: foobar
Last used group: foobar
Last event stored: /home/olli/.config/zeitig/olli/groups/foobar/source/2018-04-01T15:30:00+00:00
Last situation in foobar: Break started at 2018-04-01 17:30:00 since 595.03 hours

> z report
Working times for foobar until Thursday 26 April 2018
Week: 13
        2018-04-01 08:00:00 - 12:00:00 - 4.00 - foo
        2018-04-01 13:00:00 - 17:30:00 - 4.50
Total hours: 8.50


You may create a .zeitig folder somewhere in your current working directory path to use it as the store.

For every user is a separate directory created, which containes the groups and the events sources:

    +- <user>
        +- last ---------------+
        |                      |
        +- groups              |
            |                  |
            +- <group>         |
                |              |
                +- source      |
                    |          v
                    +- <event UTC timestamp>

The events are stored as simple toml files.

Aggregates and reports are generated on the fly.

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

zeitig-0.0.2-py3-none-any.whl (14.4 kB view hashes)

Uploaded Python 3

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