TimeTracker

Version @versionName@

Sean E. Russell

If you like this app, please contribute and support future development!

TimeTracker helps you record the amount of time you spend on activities; for example, for recording time in a time sheet at work. It provides ways to view, edit, and filter times, and provides a time sheet report as well.

The Task view (the main page)

The main application view is the task view. This shows all of the tasks and a sum of their times for a selected date range. This is the main view where time is tracked.

Tasks are added by using the Task view menu's Add Task option.

To start the timer for a task, tap on the task in the task list. To stop timing, tap it again; or, tap a different task to switch timing to the other task. Two tasks can not be running at the same time.

The Change View menu item can be used to change the range of times summed for the tasks. Options are:

Times are filtered by their start date; if a time event crosses a day boundary into a day that is out of the currently selected view range, the entire range will still be included in the sum; however, none of that time will appear on the next day, so times will only appear once.

For example, if the view is set to Yesterday and there is a time event that started at 23:00 on that day and stops at 01:00 today, then the 2 hours will be included in the sum of that task for this view. If the the view is then switched to Today then that time range will not be included in this view.

A report of the times for the week can be displayed using the Report option of the main menu.

To view a log of the times for a task (for the currently selected view), the Time list option can be selected from the context menu (press-hold on a task) of the task.

Tasks can be deleted using the Delete task context menu item.

Finally, a task's name can be edited using the Edit task context menu item.

The Task view main menu (the menu button)

The main task view menu contains the following options:

Add task

This opens a dialog asking for the task name, and adds a new task to the task list. Cancel this dialog to abort the addition.

Change view

The Change view menu item can be used to change the range of times summed for the tasks. Options are: Times are filtered by their start date; if a time event crosses a day boundary into a day that is out of the currently selected view range, the entire range will still be included in the sum; however, none of that time will appear on the next day, so times will only appear once.
For example, if the view is set to Yesterday and there is a time event that started at 23:00 on that day and stops at 01:00 today, then the 2 hours will be included in the sum of that task for this view. If the the view is then switched to Today then that time range will not be included in this view.

Report

Opens the Report view.

Help

Opens a dialog showing the application version and author information, as well as a more brief version of this documentation.

The Task view context menu (press-hold on a task)

The context menu for each task contains the following options:

Edit task

Opens a dialog that can be used to change the name of a task.

Delete task

Deletes a task, and all of the times for the task.
This action can not be undone!
A confirmation dialog will be displayed before the task is deleted; cancel the confirmation dialog to abort the action.

Show times

Opens the Time log for the task.

The Report view (weekly sum of all tasks)

Use the Report menu item to view a report of the daily time sums per task for an entire week. The right-most column lists the totals per task for the week; the bottom-most row lists the totals of all tasks for the day. Each cell shows the total for a task, for a day.

The currently running time is included in the display, but is not updated in real-time.

The Time log

The Time log displays a detailed list of times for a single task. The list is filtered on the same range view that is currently selected for the main task view; if it is set to Today, then only times for today will be shown.

As is the case for the main Task view, if a time range spans days that are not in the selected view, then it will be displayed for the view on which the time starts. See the example in the Task view for more information.

The Time log view main menu (the menu button)

The menu for the Time log contains a single entry for adding a new time range.

Use the Add Time option to manually insert times into the time log.

Note that TimeTracker will not prevent you from creating times that overlap with times in other, or the same, task.

The Time log view context menu (press-hold on a time)

The Time log context menu contains the following options:

Edit time

This option can be used to adjust the start and end time of a time range. This option can also be more simply invoked by clicking on one of the times in the list.

Delete time

A time can be removed by using this option. A confirmation dialog gives the user the option of aborting the action.

Bug tracker

You can visit the development bug tracker page to see a list of known bugs and future enhancements. Email the author, using the application managers "Mail Author" option, to submit bug reports. I can't fix 'em if I don't know about 'em.

Credits

The TimeTracker application icon was borrowed from the excellent glyFX icon library by PerthWeb Pty Ltd.