Introduction

For reasons explained in the History appendix, I found the need years ago to build a simple tool for tracking my time. The format of the timelog file and some of the functionality was inspired by Gina Trapani’s Todo.txt program. It’s main feature is the simplicity of its file format:

• One entry per line
• pure text
• minimal formatting

For details of the file format, see the Format appendix.

Installation

Since rtimelog was written in Rust, the easiest way to install it is from crates.io using the cargo application. If you have cargo installed, type the following on the command line.

  $ cargo install rtimelog

If you are interested in checking out the source of the tool, you can get the latest version from the gitlab repo. You will still need to build a Rust executable to make use of rtimelog.

Conventions

Since this is a command line tool, most of the examples show running the program in a shell. The code that you would type in the command line will be in a block and preceded by a $ character. Any lines shown without the $ in the same block are the response from the program.

This is a command without any response.

  $ rtimelog start +project @Code

This is a command with a response.

  $ rtimelog curr
  +project @Code