The Cross-Platform Time Tracker
C++ CMake Objective-C++ Python QMake QML Other
Latest commit 9f74525 Nov 15, 2016 @steffen-kdab steffen-kdab committed with KDAB (Code Review) Merge "Merge remote-tracking branch 'origin/1.11'"
Permalink
Failed to load latest commit information.
Charm Merge "Merge remote-tracking branch 'origin/1.11'" Nov 15, 2016
Core Revert "[OSX DEV DO NOT REVIEW] DO NOT MERGE" Oct 14, 2016
Tests Revert "[OSX DEV DO NOT REVIEW] DO NOT MERGE" Oct 14, 2016
Tools update copyright year Jan 3, 2016
android Add androidmenifest.xml to git. Mar 17, 2014
cmake/ECM cmake - update our copies of the ECM files Aug 31, 2016
scripts Add new Windows deploy script and remove old cpack code. Aug 15, 2016
.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 Detect processor architecture and pass it to the... Oct 18, 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.