File	Date	Author	Commit
src	2025-02-27	Joachim Eibl	[cc8f7f] Adjustable fontsize
.gitignore	2020-02-01	Joachim Eibl	[92e74e] Upgrade to Qt5
COPYING	2012-05-02	joachim99	[a19ca9] Added GPL-V3 license
Readme.txt	2020-02-03	Joachim Eibl	[96a9b4] Requirement Qt5.11

Read Me

Timesheet 2020
==============
Helper tool for tracking how you spent your time.

Copyright (C) Joachim Eibl 2008-2020
License GPLv3. (See file "COPYING")
Homepage: http://jetimesheet.sourceforge.net


Requirements for compilation: Qt5.11 or newer (see qt.io)

Currently only Windows is supported.


Main features:
- Allows you to track your tasks per day.
- Per task the time, description and category are stored.
- Data is saved as a readable text file.
- Tray icon shows the current date, and when clicked the timesheet is shown.
- Summary output for printing (detailed or compact). You can copy and paste the summary to other programs.
- Tasks with category "Pause" are omitted from any sum.
- Autosave on Quit.
- Editable tables.
- Right mouse click to insert/delete lines.
- Summary modes: Compact and detailled. (You can copy and paste the summary to other programs.)


More features:
- On first start you will be asked for a storage folder. (This value will be remembered in the registry.)
  The storage files will be named "timesheet.txt" and "timesheet.txt.bak".
- File is signed (with an MD5 sum at the bottom) to prevent accidental damage.
- Before writing the new file the old file will be renamed to timesheet.txt.bak.
  If a warning informs you of a checksum mismatch, and this was no wanted manual change, 
    * backup your files first, 
    * manually rename the file. "timesheet.txt.bak"->"timesheet.txt"
    * then restart.
- The saved file has text format and can also be edited manually. If you do so just ignore the checksum error on starting timesheet again. 
- Tracking of user activity (via mouse and keyboard hook, made visible by a text below the table.)
- Automessages on Inactivity/Activation/Suspend/Resume
- Combobox for description displays recently used descriptions.
- Use category "Pause" for tasks that shall not appear in any summary.
- The sum per day is shown below the table.
- Color highlighting (after table refresh): 
    * Light blue is for category "Pause"
    * Yellow is for automatically inserted descriptions.
- On startup Timesheet detects if another instance is already running and prevents running twice.

Quirks:
- Each line in the table must contain a description and a category. Otherwise it will be deleted.
- Automatic saving on shutdown might not reliably work for network drives. 
  A local storage directory is recommended.
- Pops up at adjustable intervals to let you update your tasks doesn't always work because
  the Timesheet window will not always come to front automatically, because the operating system 
  (Windows) might prevent this. 
- Better don't remove Category items that are in use.


Recommendation:
- Make a backup of your files from time to time. 

Build:
- Needs Qt5 for building. Use the src/timesheet.pro-file.

Installation:
- Copy the timesheet.exe and needed dlls to a folder of your choice.
- For autostart create a shortcut and move it to the autostart folder (Type "shell:startup" in explorer.)