Getting started with Auto-Tracking

Find out how you can take full advantage of Auto-Tracking

What is Auto-Tracking?

Auto-Tracking starts the timer for you without taking away your control over it. You only need to define a few rules for Klokki by which it will be guided. After that, Klokki will work completely autonomous — start and pause the timer depending on what you do.

How to enable Auto-Tracking

To enable Auto-Tracking, you will need to give Klokki accessibility permission. Follow the steps below to activate it.

First, you'll need to open the Klokki settings and go to the "Auto-Tracking" tab. Press the "Activate" button to proceed.

Follow the steps that are described to enable accessibility permission.

After you've completed all the steps, you should be able to see the following window. That's it — Auto-Tracking is activated!

Create Auto-Tracking Rules

Now after you've successfully activated Auto-Tracking, you are able to create rules on individual tasks. Rules are defined by a list of action-attributes which you can configure to your needs.

Hover a task for which you want to configure a rule and click on the Auto-Tracking button to open the rules configurator.

Let's get familiar with the rules configurator to understand what is possible here.

Before we start building a rule, let's understand the difference between a stand-alone action-attribute and a combination of attributes.

You can add multiple action-attributes in a row. If you unite them into a combination, then Auto-Tracking will only start when all of the actions within the combination are detected.

To add an action attribute click on the "+"-button. Get familiar with all the possible action-attributes. Click on the drop-down with "Launched Application" being preselected, to see the whole list.


Launched Application

Choose a specific application as an action-attribute. As soon as the app is launched Auto-Tracking will be activated and the pre-counting begins. Quit that app to stop time-tracking.

Active Application

This attribute is similar to the previous one with the exception that it only activates if the chosen application is in focus. If the focus is lost because you, e.g., switched to a different window the down-counting will begin and then stop Auto-Tracking.

Working on File

Select a file, and as soon as you start working on it, Auto-Tracking will be activated. "Working on File" behaves the same as the "Active Application" and only tracks the time if the chosen file is in focus.

Working on File in Folder

Select a folder, and as soon as you start working on any file inside that folder, Auto-Tracking will be activated.

Window Title

This action will start Auto-Tracking as soon as it detects a window with a title text that you set up and will only stop if the defined window is no longer open. This action also provides a few options for how to set it up. Choose from the options: "is", "contains", "starts with" and "ends with" to specify the detection of the window title text.

Website URL

Enter a URL, and as soon as you open the chosen website, Auto-Tracking will be activated. This attribute is also only active as long as the website is in focus. It has the same specification options as "Window Title".

As you can see, Klokki provides a variety of action-attributes to choose from and create the perfect rule that works best for you. Try to combine actions to achieve a more specific rule. Check the examples below to get started.

Example 1

Create a combination of two actions:
"Launched Application" e.g. "Photoshop" and
"Working on File" e.g. "photoshoot_edits.psd"

Now if you open the "photoshoot_edits.psd" with "Photoshop", Auto-Tracking will be activated.

Example 2

Create two separate actions:
"Working on File" e.g. "index.html"
"Website URL" + "contains" e.g. "google"

With this rule, Auto-Tracking will start if you either work on "index.html" or/and visit Google's website.

Example 3

Create two separate actions:
"Active Application" e.g. "Numbers"
"Website URL" + "contains" e.g. "nasdaq"

This rule will only be activated if you browse the Nasdaq website or/and have the "Numbers" application in front of you.

Frozen Auto-Tracking State

If you manually pause a running Auto-Tracking session, Klokki will freeze the rule for the running task. Until you unfreeze them — Auto-Tracking won't start for this specific task. That's needed because Klokki cannot know that you are active again and therefore can't start the timer. If you reactivate any of the rules-attributes, you will achieve the same effect.

Disable Rules or Auto-Tracking Completely

If you no longer want to track the rules, you can turn them off individually. Enter the rules configurator and turn off the switch on the top.

In case, if you've decided that Auto-Tracking shouldn't operate entirely, open the Klokki settings and click on the "Auto-Tracking" tab. Turn off the switch, to completely disable Auto-Tracking.