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