KTimeTracker: Difference between revisions

From KDE Wiki Sandbox
(Moved Developing section to separate page)
(not subsections; forum link (Kontact & PIM seems to be most fitting place))
 
(80 intermediate revisions by 13 users not shown)
Line 1: Line 1:
{{Template:I18n/Language Navigation Bar|KTimeTracker}}
<languages />
{{Infobox_Software
| title                  = Ktimetracker
}}


= What is KTimeTracker =
{|class="tablecenter vertical-centered"
|[[Image:ktimetracker.png|thumb|300px|KTimeTracker]]||<translate> <!--T:1-->
'''KTimeTracker is a todo management and time tracking application.</translate>'''
|}


KTimeTracker tracks time spent on various tasks. It is useful for tracking billable hours and can report the hours logged by task and day.
<translate>
This time history can be exported to a comma-delimited text file for import into other billing and/or project management tools.
KTimeTracker detects when your keyboard and mouse are idle and can associate different tasks with different desktops, two tools that can help keep the timer running on the correct task.


[[Image:ktimetracker.png|500px|center]]
== Overview == <!--T:3-->


= Using KTimeTracker =
<!--T:4-->
'''KTimeTracker''' tracks time spent on various tasks.


== What KTimeTracker can do for you ==
<!--T:5-->
The current stable version of KTimeTracker (4.1) can:
;Challenge: You are a software consultant with several customers and many project assignments. When billing your customers, you are required to report how much time you spend on what task.
* organize and stopwatch tasks, subtasks
KTimeTracker allows you to organize and stopwatch your work. You can put your daily todo-list into that tool. You can group your work by tasks, subtask and n-th level tasks, meaning that every subtask can still have a subtask below it, up to some 1000 levels.


* edit task history and comments
<!--T:6-->
KTimeTracker allows you to edit your task's history and to put a comment for every event that you have stopped:
;Solution: Use '''KTimeTracker''' to hold a list of projects and tasks. Whenever you switch your activity, double-click on the respective task and see how its time gets tracked. At the end of the day (or month) you can obtain a journal how much time you spent on what task.


== Get it == <!--T:34-->
<!--T:35-->
You can install KTimeTracker either
<!--T:36-->
* by means of your Linux distribution, or
* by compiling from source code ([https://download.kde.org/stable/ktimetracker/ stable releases], [https://commits.kde.org/ktimetracker Git repository]), or
* with pre-built installers/packages for Windows and macOS for [https://download.kde.org/stable/ktimetracker/5.0.1/ stable releases] and [https://binary-factory.kde.org/ nightly snapshots].
== Features == <!--T:7-->
<!--T:8-->
The current stable version of '''KTimeTracker''' (5.0.1) can:
<!--T:9-->
* Organize tasks into subtasks:
**'''KTimeTracker''' allows you to organize your work like a todo-list. You can group your work by tasks and subtask. Every subtask can still have a subtask below it, up to some 1000 levels.
<!--T:10-->
* Track your time:
**Whenever you start working on a new task, just double-click the corresponding task in your todo-list. You will see a clock appearing next to this task indicating its time is now recorded.
<!--T:11-->
* Edit task history and comments:
**'''KTimeTracker''' allows you to edit your task's history and to put a comment for every work-event:
<!--T:12-->
[[Image:ktimetracker-history.png|500px|center]]
[[Image:ktimetracker-history.png|500px|center]]


=== Options ===
<!--T:13-->
KTimeTracker 4 has the following behavior options:
* Pause detection:
**When going for lunch, it may happen that you forget to stop timetracking before. No problem: the idle time detector in '''KTimeTracker''' will pop up after a configurable amount of time giving you the possibility to revert (as if you said, "I was '''not''' working during this time.") or continue timing (as if you said "I was working during this time.").
 
== Options == <!--T:14-->
 
<!--T:15-->
'''KTimeTracker 5''' has not more and not less than the following options:
 
<!--T:16-->
[[Image:Snapshot-ktimetracker-options-behavior.png|center]]
 
<!--T:17-->
[[Image:Snapshot-ktimetracker-options-appearance.png|center]]
 
<!--T:18-->
''Configuration for PDA'': Removes the search-bar to gain screen real estate. Assumes a touch-screen and pops up a context menu on every mouse click, even with the left button.
 
<!--T:19-->
[[Image:Snapshot-ktimetracker-options-storage.png|center]]
 
 
== Compatibility == <!--T:20-->
 
<!--T:21-->
There have been 3 file format changes in the over 10-year-history of KTimeTracker:
{| class="wikitable sortable" border=1
! KDE SC version !! KTimeTracker file
|-
| -3.1        || flat files
|-
| 3.2-3.5    || iCal files with X-KDE-karm fields, import possibility for flat files
|-
| 4.x, 5.0  || iCal files with X-KDE-KTimeTracker fields, automated import for iCal files with X-KDE-karm fields
|-
|}
 
<!--T:22-->
Because of the iCal file format, KTimeTracker is compatible with korganizer. You can even work synchroneously on one file with korganizer and KTimeTracker. If one program changes the file, the updates will be propagated to the other application automatically.
 
== Does it scale? == <!--T:25-->
 
<!--T:26-->
'''KTimeTracker''' scales well and it regularly tested with a 1.2 MB file ([https://bugs.kde.org/attachment.cgi?id=14413&action=view download it]) available from ([https://bugs.kde.org/show_bug.cgi?id=110523 KDE Bug report 110523]). A '''KTimeTracker''' benchmark is available [https://cgit.kde.org/ktimetracker.git/tree/test here].
 
== Support == <!--T:27-->
 
<!--T:28-->
As you explore '''KTimeTracker''' you'll find questions that need answering.
*Chat with us, the KDE users, on [irc://chat.freenode.net#kde IRC, the KDE users' channel].
*Forum under Kontact & PIM https://forum.kde.org/viewforum.php?f=215


[[Image:Snapshot-ktimetracker-options.png|center]]
== Videos == <!--T:29-->


== Compatibility ==
<!--T:30-->
Up to KDE 3.1 (incl.), flat files were used to store the data. From KDE 3.2 on, the iCal format is used, but flat files can still be imported until KDE 4. With KDE 4, the custom fields
Video demos are here:
X-KDE-karm-duration, X-KDE-karm-totalTaskTime, X-KDE-karm-totalSessionTime and X-KDE-karm-desktopList were renamed to X-KDE-KTimeTracker-duration and the respective other names. KTimeTracker 4 can still read karm iCal files, but not the other way round.
* [http://www.youtube.com/watch?v=LdlEkJAMj_A The "track active applications" demo]


== Does it scale ==
== See also == <!--T:31-->
KTimeTracker scales well and it regularly tested with a 1.2 MB file (https://bugs.kde.org/attachment.cgi?id=14413&action=view) available from (https://bugs.kde.org/show_bug.cgi?id=110523). A ktimetracker benchmark is available from [http://websvn.kde.org:80/trunk/KDE/kdepim/ktimetracker/test/ktimetrackerbenchmark?view=markup here].


== Support ==
<!--T:32-->
* needing support ? Ask and answer in the chat at irc.kde.org, channel #kde
* [https://community.kde.org/KTimeTracker Become a KTimeTracker developer]


If you are interested in helping to develop KTimeTracker, see '''[[KTimeTracker/Developing the Developing section]]'''
<!--T:33-->
[[Category:Office]]
</translate>

Latest revision as of 16:04, 7 March 2021

KTimeTracker
KTimeTracker is a todo management and time tracking application.


Overview

KTimeTracker tracks time spent on various tasks.

Challenge
You are a software consultant with several customers and many project assignments. When billing your customers, you are required to report how much time you spend on what task.
Solution
Use KTimeTracker to hold a list of projects and tasks. Whenever you switch your activity, double-click on the respective task and see how its time gets tracked. At the end of the day (or month) you can obtain a journal how much time you spent on what task.

Get it

You can install KTimeTracker either

Features

The current stable version of KTimeTracker (5.0.1) can:

  • Organize tasks into subtasks:
    • KTimeTracker allows you to organize your work like a todo-list. You can group your work by tasks and subtask. Every subtask can still have a subtask below it, up to some 1000 levels.
  • Track your time:
    • Whenever you start working on a new task, just double-click the corresponding task in your todo-list. You will see a clock appearing next to this task indicating its time is now recorded.
  • Edit task history and comments:
    • KTimeTracker allows you to edit your task's history and to put a comment for every work-event:
  • Pause detection:
    • When going for lunch, it may happen that you forget to stop timetracking before. No problem: the idle time detector in KTimeTracker will pop up after a configurable amount of time giving you the possibility to revert (as if you said, "I was not working during this time.") or continue timing (as if you said "I was working during this time.").

Options

KTimeTracker 5 has not more and not less than the following options:

Configuration for PDA: Removes the search-bar to gain screen real estate. Assumes a touch-screen and pops up a context menu on every mouse click, even with the left button.


Compatibility

There have been 3 file format changes in the over 10-year-history of KTimeTracker:

KDE SC version KTimeTracker file
-3.1 flat files
3.2-3.5 iCal files with X-KDE-karm fields, import possibility for flat files
4.x, 5.0 iCal files with X-KDE-KTimeTracker fields, automated import for iCal files with X-KDE-karm fields

Because of the iCal file format, KTimeTracker is compatible with korganizer. You can even work synchroneously on one file with korganizer and KTimeTracker. If one program changes the file, the updates will be propagated to the other application automatically.

Does it scale?

KTimeTracker scales well and it regularly tested with a 1.2 MB file (download it) available from (KDE Bug report 110523). A KTimeTracker benchmark is available here.

Support

As you explore KTimeTracker you'll find questions that need answering.

Videos

Video demos are here:

See also