TimeTracker

File Release Notes and Changelog

Release Name: V4.0

Notes:
                                +-----+   +-----+
                                +-+ +-+   +-+ +-+
                                  | |       | |
                                  +-+       +-+
                                  
  Copyright (C) 2007 by Roland Bennett
  COPYRIGHT NOTICE: See the GNU GPL.

-------------------------------------------------------------------------------
What is new?
-------------------------------------------------------------------------------

4.0.0 - (15 April 2007) Major release.
                        Changed look&feel to match Windows Task Manager.
                        Added elapsed time to Add Item dialog.
                        Changed list view to "virtual" mode to improve
                        performance for a large number of items.
                        Added tree and chart view (for window items only).
3.3.0 - (22 March 2007) Fixed critical window handle leak.
                        Added different system tray icons for when a task
                        has started.
                        Added Edit INI to popup menu.
3.2.0 - (19 March 2007) CSV file items are now sorted according to time.
                        CSV file window items are now also filtered when 
                        selected on the popup menu.
                        Added Uptime.csv file.
                        Fixed popup menu items when minimized.
                        Added detailed error messages when loading task 
                        list fails.
3.1.0 - (10 March 2007) Close button now minimizes the window.
                        Added branding to popup menu.
                        Prevented duplicate entries for a new rule.
3.0.0 - (03 March 2007) This is the initial public release.

-------------------------------------------------------------------------------
What is it?
-------------------------------------------------------------------------------

TimeTracker (TT) is a PC activity monitor for Windows. 

Ever spent the day in front of your PC, only to wonder at 5pm what you did that 
day? TT will tell you.

TT will sit in your system tray and check every second which window is currently
active on your desktop. The active window is the one you are currently typing or
clicking in, and should be an accurate estimate of what you are working on. TT
captures the window caption from the title bar and tracks the active time for 
that window.

TT also allows the traditional feature of manual timers, you may enter your own
task name and either double click (or use Space or Enter) to start/stop the
task timer.

The main aim of TT is though to be a time tracking tool that requires very 
little user intervention. Who wants to do the boring work of timesheets? Rules
allow TT to be able to tell which window activity belongs to which user task.
Rules can be one or more partial window captions or file names, when any one of
these conditions are met TT will start the task timer. When the conditions
cease, TT will stop the task timer.

The window and task active times can be saved to CSV (comma separated value) 
files.

TT was designed to use very little computer resources, especially when running
minimized.

TT does not need to be installed, simply run the exe file.

The main functions of TT are available in a popup menu, right click anywhere in 
the window or on the system tray icon to display the popup menu.

-------------------------------------------------------------------------------
What it is not?
-------------------------------------------------------------------------------

TT does not capture keystrokes or mouse clicks. 
TT does not use the Internet.
TT does not use the Windows registry and will run from any USB flash disk.

-------------------------------------------------------------------------------
What does it run on?
-------------------------------------------------------------------------------

TT was tested under Windows 98, XP and Vista. It should also run under 95 and 
2000.

-------------------------------------------------------------------------------
Settings
-------------------------------------------------------------------------------

The application settings are stored in the 'TimeTracker.ini' file. The options
that can be changed are:

TransparencyPercentage=30    ;Sets the see-through % of the main window
                              (XP only)
FilterView=0                 ;Same as the Filter Windows popup menu item
FilterCutoffSeconds=120      ;When a window is active for less than this value 
                              it is not displayed in the list
ListRefreshRateSeconds=1     ;When TT is not minimzed, this is the update rate 
                              of the displayed list
AlwaysOnTop=0                ;Same as the Always On Top popup menu item
IdleCutoffSeconds=60         ;The value where no mouse or keyboard input is 
                              considered to be idle state
IgnoreWindowCaptions=0       ;Only capture process file names
PromptWhenClosing=1          ;Remove the "Save List" dialog box when closing 
                              the application
SaveTasksOnly=0              ;Same as the "Save Tasks Only" popup menu item.
AutoSave=0                   ;Same as the "Auto Save" popup menu item. 
                              Automatically saves the list when the application 
                              is closed.
ListGridLines=1              ;Turn on/off grid lines in the list view.

To enable a setting use '1', to disable use '0'.

-------------------------------------------------------------------------------
Rule file format
-------------------------------------------------------------------------------

Rules are stored in txt files with this format:

Taskname="Window Caption1", "Window Caption2", "Window Caption3", "File name"

The window captions and file names are case-sensitive. They are considered to be
fragments, if the caption or file name forms part of any active window caption
or its owner file name then the rule conditions are satisfied.

To add a rule, select "Add Rule" from the popup menu.

-------------------------------------------------------------------------------
Hints and Tips
-------------------------------------------------------------------------------

(1) Place TT in your Windows Startup folder to launch whenever Windows boots. 

(2) To hide all window captions, set the FilterCutoffSeconds value very high.

(3) The keyboard can be used to edit tasks. "+", "Insert" to add a task, "-", 
    "Del" to remove a task.

(4) Use OpenOffice.org Calc or Microsoft Excel to import the CSV file.

(5) If the amount of windows in the list at the end of the day is staggering,
    try to use the IgnoreWindowCaptions option. This will ignore the caption 
    in the window title bar and only record the owner file name of that window.

(6) Click on a column header to sort that column.

(7) Do NOT show TT to your boss! :-)

-------------------------------------------------------------------------------
                                    THE END
-------------------------------------------------------------------------------

Changes: