Skip to main content

A Gtk+ time tracking application

Project description

GTimeLog is a simple app for keeping track of time.

latest version build status test coverage screenshot


GTimeLog is packaged for Debian and Ubuntu:

sudo apt-get install gtimelog

For Ubuntu, a newer version can usually be found in the PPA:

You can fetch the latest released version from PyPI

$ pip install gtimelog
$ gtimelog

You can run it from a source checkout without an explicit installation step:

$ git clone
$ cd gtimelog
$ ./gtimelog

System requirements:

  • Python (2.7 or 3.3+)

  • PyGObject

  • gobject-introspection type libraries for GTK+, Pango


This is work in progress:



Mailing list: (archive at

IRC: #gtimelog on

Source code:

Report bugs at

There’s an old bugtracker at

I sometimes also browse distribution bugs:


GTimeLog was mainly written by Marius Gedminas <>.

Barry Warsaw <> stepped in as a co-maintainer when Marius burned out. Then Barry got busy and Marius recovered.

Many excellent contributors are listed in CONTRIBUTORS.rst


0.10.0 (2015-09-29)

  • Use Tango colors in the main text buffer (GH: #13).

  • Allow tagging entries (GH: #19)

    • The syntax is category: text -- tag1 tag2

    • Per-tag summaries show up in reports

  • Use GtkApplication instead of own DBus server for enforcing single-instance.

    • Drop –replace, –ignore-dbus command-line options because of this.

    • Require glib and gio to be version 2.40 or newer for sane GtkApplication-based command line parsing (check with pkg-config --modversion glib-2.0 gio-2.0).

  • Remove obsolete code:

    • Drop support for Python 2.6 (PyGObject dropped support for it long ago).

    • Drop PyGtk/Gtk+ 2 support code (it didn’t work since 0.9.1 anyway).

    • Drop EggTrayIcon support (it was for Gtk+ 2 only anyway).

    • Drop the –prefer-pygtk command-line option.

  • Disable tray icon by default for new users (existing gtimelogrc files will be untouched).

  • Improve tray icon selection logic for best contrast (GH: #29).

0.9.3 (2015-09-29)

  • Adding new entries didn’t update total weekly numbers (GH: #28).

0.9.2 (2014-09-28)

  • Note that Gtk+ 2.x is no longer supported (this regressed somewhere between 0.9.0 and 0.9.1, but I didn’t notice because I have no access to a system that has Gtk+ 2.x).

  • Fix to work on Python 3 when your locale is not UTF-8 (LP: #1263772).

  • Fix two Gtk-CRITICAL warnings on startup (GH: #14).

  • Fix Unicode warning when adding entries (GH: #20).

  • Speed up entry addition (GH: #21).

  • Fix Unicode error when navigating history with PageUp/PageDown (GH: #22).

  • Update current task time when autoreloading (GH: #23).

  • Fix ‘LocaleError: unknown encoding:’ on Mac OS X (GH: #25).

  • Fix ‘TypeError: unorderable types: NoneType() < str()’ in summary view on Python 3 (GH: #26).

Older versions

See the full changelog.

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

gtimelog-0.10.0.tar.gz (258.2 kB view hashes)

Uploaded source

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