Major Components

STOPTHAT is not one executable. It is a suite of software that works together to perform the task of time tracking and time reporting. This section gives an overview of the major parts.

STOPTHAT GUI GUI application for adding time data into the system.
st Command line application for adding time data, listing projects.
STOPWHAT Command line application for creating text reports of time spent.
STOPLOOK Command line application for creating timeline graphics.
TIMEVIEW GUI application for viewing stacks of timelines.
stopcomm.py This Python module stores code that is common between the applications.
Configuration Files Configure your buckets, projects, file paths, and timeline graphics.
Database Time data is stored in a plain text database, each entry on its own line.
Clipboard Each device which will be adding data gets its own clipboard. This is the same format as the database. It is a holding pen for data that will later be added to the database.
Web Service Maintains the full database and helps each device unload its clipboard.


There are many components, but using the software feels natural.

First you would add some time data. If you are using a desktop, use STOPTHAT GUI to add some data. If using the command line use st add to add some data.

The next thing you might do is show the timeline graphic for today, using Timeview. This shows you how you have spent your day so far, how much time is remaining. It also shows sunrise, sunset, moon phase, and other fun stuff.

Next you can use the command line to generate a text report of where you spent your time, using STOPWHAT. This report can be filtered by project, date, or search parameter.

So far you have just been adding data to your local clipboard. Now you can use clean_clipboard.py to send your clipboard to the web service that maintains the full database.