ti — A silly simple time tracker
ti is a small command line time tracking application. Simple basic usage
looks like this
$ ti on my-project $ ti fin
You can also give it human-readable times.
$ ti on my-project 30mins ago
ti sports many other cool features. Read along to discover.
ti is a simple command line time tracker. It has been completely re-written in
python (from being a bash script) and has (almost) complete test coverage. It is
inspired by timed, which is a nice project
and you should check out if you don't like
ti. It also takes inspiration from
the simplicity of t.
If a time tracker tool makes me think for more than 3-5 seconds, I lose my line
of thought and forget what I was doing. This is why I created
you'll be as fast as you can type, which you should be good with anyway.
The most important part about
ti is that it
provides just a few commands to manage your time tracking and gets out
of your way. All data is saved in a JSON file (
~/.ti-sheet, can be changed by
$SHEET_FILE) for easy access to whatever you need to do. Some ideas,
- Read your json file to generate beautiful html reports.
- Build monthly statistics based on tags or the tasks themselves.
- Read the currently working project and make it show up in your terminal prompt. May be even with how long you've been on it. (!!!)
Its your data.
Oh and by the way, the source is a fairly small python script, so if you know python, you may want to skim over it to get a better feel of how it works.
Note: If you have used the previous bash version of
ti, which was horribly
tied up to only work on linux, you might notice the lack of plugins in this
python version. I am not really missing them, so I might not add them. If anyone
has any interesting use cases for it, I'm willing to consider.
Here's the minimal usage style:
$ ti on my-project Start working on my-project. $ ti status You have been working on my-project for less than a minute. $ ti fin So you stopped working on my-project.
fin can take a time (format described further down) at which to apply
$ ti on another-project 2 hours ago Start working on another-project. $ ti s You have been working on another-project for about 2 hours. $ ti fin 30 minutes ago So you stopped working on another-project.
Also illustrating in the previous example is short aliases of all commands,
their first letter. Like,
Put brief notes on what you've been doing.
$ ti note waiting for Napoleon to take over the world $ ti n another simple note for demo purposes
Tag your activities for fun and profit.
$ ti tag imp
Get a log of all activities with the
$ ti log
ti -h (or
help or just
h) to get a short command summary
ti (o|on) <name> [<time>...]
Start tracking time for the project/activity given by
<name>. For example,
ti on conquest
ti to start tracking for the activitiy
conquest now. You can
optionally specify a relative time in the past like so,
ti on conquest 10mins ago
The format of the time is detailed further below.
ti (f|fin) [<time>...]
End tracking for the current activity now. Just like with
on command above,
you can give an optional time to the past. Example
ti fin 10mins ago
ti that you finished working on the current activity at, well, 10
Gives short human readable message on the current status. i.e., whether anything is being tracked currently or not. Example,
$ ti on conqering-the-world Start working on conqering-the-world. $ ti status You have been working on `conqering-the-world` for less than a minute.
ti (t|tag) <tag>...
This command adds the given tags to the current activity. Tags are not currently
used within the
ti time tracker, but they will be saved in the json data file.
You may use them for whatever purposes you like.
For example, if you have a script to generate a html report from your
you could tag some activities with a tag like
important so that, that
activity will appear in red in the final html report.
Use it like,
ti tag red for-joe
adds the tags
for-joe to the current activitiy. You can specify any
number of tags.
Tags are currently for your purpose. Use them as you see fit.
ti (n|note) <note-text>...
This command adds a note on the current activity. Again, like tags, this has no
significance with the time tracking aspect of
ti. This is for your own
recording purposes and for the scripts your write to process your
Use it like,
ti note Discuss this with the other team.
adds the note
Discuss this with the other team. to the current activity.
ti (l|log) [today]
Gives a table like representation of all activities and total time spent on each of them.
Currently only the following are recognized. If there is something that is not
handled, but should be, please open an issue about it or a pull request
(function in question is
n seconds ago can be written as:
- nseconds ago
- nsecond ago
- nsecs ago
- nsec ago
- ns ago
ain place of n in all above cases, to mean 1 second.
a sec ago
25 seconds ago,
n minutes ago can be written as:
- nminutes ago
- nminute ago
- nmins ago
- nmin ago
ain place of n in all above cases, to mean 1 minute.
a minute ago,
10 minutes ago.
n hours ago can be written as:
- nhours ago
- nhour ago
- nhrs ago
- nhr ago
anin place of n in all above cases, to mean 1 hour.
an hour ago,
an hr ago,
Where n is an arbitrary number and any number of spaces between n and the time unit are allowed.
The project is beta. If you find any bug or have any feedback, please do open an issue on Github issues.
You can download
ti from the source on
- Put it somewhere in your
$PATHand make sure it has executable permissions.
- Install pyyaml using the command
pip install --user pyyaml.
- Install colorama using the command
pip install --user colorama.
ti should be working fine.
Also, visit the project page on github for any further details.