Skip to content
bottomquark edited this page Mar 22, 2017 · 3 revisions

Some use cases and how to handle them using STT

Here, some common use cases are described and how to handle them using STT. Feel free to contact the authors or create an issue on Github if something is unclear or your use case has not been covered here.

I forgot to track something

It happens quite often: you work on a task and someone interrupts you. This can be fixed quickly:

Using the GUI

just type "on something" from X to Y and confirm. Example: on the task you forgot from 12:30 to 13:20

Using the CLI

the following example will ad a new time tracking item for today, 12:30 to 13:20 and does not change any other items. stt on the task you forgot from 12:30 to 13:20

I forgot to end the previous day

This is also quite common. You walk out of the office and the next morning you see that you didn't clock off and the task you were working on is still displayed as "active" in STT.

Using the GUI

coming soon

Using the CLI

coming soon

I want to know how much time I spent on one task

Using the GUI

not yet possible. If you need that feature, please create an issue.

Using the CLI

stt report chess outputs all items matching "chess" along with the summed up times.

I need to change the comment of many items quickly

It may happen that many comments must be changed. Maybe a word is misspelled in many comments or you need to bulk change comments for other reasons.

STT does (currently) not have built in support for bulk changing many comments but the format of its "database" is very simple: it's just text. Therefore you can just open $HOME/.stt with your favorite text editor and use its search and replace feature or use shell scripts to edit the file. The format of .stt should be quite easy to follow: one row of the file represents one time tracking item. First, there is the start date and time, then the end start and time separated by white space. The rest of the line is the comment of the item.

Before you do so, it is advisable to create a backup in case something goes wrong and you replace too much or wrong things...