Skip to main content

Simple time tracking for simple people

Project description

Test state on master Coverage state on master Current PyPI release

rdial is a simple way to track the time you spend on tasks. It tracks the name of a task, its start time, its duration and optionally a message… nothing more.

rdial is released under the GPL v3 license.


rdial’s mandatory dependencies outside of the standard library are:

It should work with Python version 3.5, or newer. If rdial doesn’t work with the version of Python you have installed, file an issue and I’ll endeavour to fix it.

The package has been tested on many UNIX-like systems, including Linux and OS X, but it may work fine on other systems too.

To run the tests you’ll need pytest. Once you have pytest installed you can run the tests with the following commands:

$ pytest tests


The database is just a directory of simple text files, making it useful to use and abuse in other applications. A sample database could be a file named task.csv with the following contents:

2011-05-04T08:00:00Z,PT01H00M00S,working on issue 4

and a task2.csv file with the following contents:


The format is a CSV file containing the following fields:

  1. Start time expressed in UTC
  2. Task duration
  3. Message associated with the event

The start time and duration fields are given as ISO 8601 formatted strings.

If a line does not contain a duration entry, then the task is considered to be running.


$ rdial start <task_name>
$ rdial stop
$ rdial report
| task  | time           |
| task  |        1:00:00 |
| task2 | 1 day, 0:15:00 |


I’d like to thank the following people who have contributed to rdial.


  • Nathan McGregor

Bug reports

  • Delphine Beauchemin
  • Henry Richards
  • James Gaffney
  • Ryan Sutton
  • Stephen Thorne


  • Adam Baxter
  • Kevin Simmons

If I’ve forgotten to include your name I wholeheartedly apologise. Just drop me a mail and I’ll update the list!


If you find any problems, bugs or just have a question about this package either file an issue or drop me a mail.

If you’ve found a bug please try to include a minimal testcase that reproduces the problem, or even better a patch that fixes it!

Project details

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
rdial-0.17.0-py3-none-any.whl (22.3 kB) Copy SHA256 hash SHA256 Wheel py3 Dec 14, 2017
rdial-0.17.0.tar.gz (67.0 kB) Copy SHA256 hash SHA256 Source None Dec 14, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page