The Cross-Platform Time Tracker
C++ CMake Objective-C++ Python QMake QML Other
Latest commit 6802d5f Jan 31, 2017 @TheOneRing TheOneRing committed with frankosterfeld Mark the correct destructor as virtual
Change-Id: I1f9855b5e145361655fa783fa5142f92f205074e
Reviewed-on: https://codereview.kdab.com/42418
Tested-by: Continuous Integration <build@kdab.com>
Reviewed-by: Frank Osterfeld <frank.osterfeld@kdab.com>
Permalink
Failed to load latest commit information.
Charm Remove moc includes, not needed with cmake automoc. Jan 31, 2017
Core Mark the correct destructor as virtual Jan 31, 2017
Tests Remove moc includes, not needed with cmake automoc. Jan 31, 2017
Tools Remove moc includes, not needed with cmake automoc. Jan 31, 2017
android Add androidmenifest.xml to git. Mar 17, 2014
cmake/ECM cmake - update our copies of the ECM files Aug 31, 2016
scripts update Copyright year Jan 5, 2017
.gitignore Add androidmenifest.xml to git. Mar 17, 2014
.krazy .krazy - skip files in cmake/ECM Aug 31, 2016
BUILD Add build instructions Feb 23, 2016
CMakeLists.txt Port QtScript usage to QJsonDocument Dec 13, 2016
COPYING COPYING - add the file referred to by the license in Keychain files Oct 6, 2015
Charm.pro Get rid of 3 window system. Feb 23, 2016
CharmCMake.h.cmake Don't ship qtkeychain Jul 28, 2016
License.txt Update and fix the documentation. Aug 13, 2010
ReadMe.markdown Use link to ReadMe.txt. Jan 13, 2012
ReadMe.txt Update path to OS X/Windows binaries Mar 27, 2015
charmtimetracker.dsc Merge remote-tracking branch 'origin/1.11' Nov 2, 2016
charmtimetracker.spec Merge remote-tracking branch 'origin/1.11' Nov 2, 2016
debian.changelog Sigh, typo Nov 2, 2016
debian.compat improve debian packing to make xUbuntu 16.10 happy on the OBS Oct 27, 2016
debian.control improve debian packing to make xUbuntu 16.10 happy on the OBS Oct 27, 2016
debian.rules Prepare OBS files for next release. Changelog etc. still needs to be … Nov 2, 2016

ReadMe.markdown

Charm - the Cross-Platform Time Tracker

Whether you are a busy professional who needs to keep track time spent on projects or a student who wants to plan their studies: knowing how your time is spent is a good idea.

Charm is a program for OS X, Linux and Windows that helps to keep track of time. It is built around two major ideas - tasks and events. Tasks are the things time is spend on, repeatedly. For example, ironing laundry is a task. The laundry done for two hours on last Tuesday is an event in that task. When doing laundry multiple times, the events will be accumulated, and can later be printed in activity reports or weekly time sheets. So in case laundry would be done for three hours on Wednesday again, the activity report for the "Ironing Laundry" task would list the event on tuesday, the event on wednesday and a total of five hours.

Tasks

By default, the list of tasks known to Charm is empty. They have to be created manually. So the first time work is done on a task, the task entry needs to be created in the task list. Then, by selecting a task and starting it, time will be recorded on that task. A comment can be added that may help to identify later what the individual event was for. Switching from one task to another is a matter of starting the other task.

Tasks can have subtasks, and create a hierarchy this way. It is recommended to create rather few top level tasks, since tasks are also used to group in reports. Other tasks can then be created as children or even grandchildren of the top level tasks.

Events

Every time time is recorded for a task, an event is created. What events exist can be seen in the event editor (View->Event Editor). Also, new events can be created there (without recording them), modified or deleted.

Reports

Activity Reports

Activity Reports group all events that happened in a certain time frame, like a day or a week. They are handy to get an overview of what was worked on during that time.

Time Sheets

Time Sheets are created per week, and group event time to tasks and week days. Time Sheets are great to report to the boss, you see.

Downloads

For released versions, binary packages are available:

For various Linux distributions, packages are available via the openSUSE Build Service.

For Windows and OS X, find installers here.

Authors and License

Charm has been developed by Mirko Boehm (mirko@kde.org), as a work of fun and experimentation. The current maintainers are Frank Osterfeld and Guillermo A. Amaral B.

Charm is Free Software, developed under the terms of the GPL. While we hope it is of good use, there is no guaranty of function or usefulness of any kind.

Feedback is encouraged and always welcome. Feel free to suggest improvements, or point out bugs in the software.