Auto-tracker is a Desktop feature in Toggl Focus that automatically starts and stops time tracking based on which application or window is active on your computer — so you spend less time manually managing your timer.
Getting started
Auto-tracker is disabled by default. To enable it:
- Open Toggl Focus and go to Settings
- Scroll to the bottom and click Desktop Settings
- Click Auto-tracker
- Toggle Enable autotracker on. You can then configure all settings below it
Settings
Enable autotracker
All other settings and rules are inactive and cannot be used until this is enabled.
Stop timer when no activity matches rules
When enabled, your timer will automatically stop if you switch to a window that doesn’t match any of your tracking rules. Useful if you want tracking to be strictly rule-bound with no manual cleanup.
Only track after app is active for
Controls how long a window must remain active before Auto-tracker starts recording. The default is 5 seconds.
You can adjust this to suit your working style a longer threshold (e.g. 45 seconds) avoids false starts from quick context switches, while a shorter one gives you near-instant tracking once you’ve settled into a window.
Tracking rules
Tracking rules are the core of Auto-tracker. Each rule defines a window title condition that, when matched, automatically links your active window to a task and starts the timer.
To create a new rule:
- Click + Add tracking rule
- Under When app or window contains, enter the app name or keyword to match (e.g.
Roadmap,Slack) - Under Match using, select either:
- Exact phrase: the window title must match exactly
- Any words: the window title only needs to contain the keyword
- Under Track as, select or enter the task to track against
- Configure the two toggles:
- Trigger even when a timer is already running: if on, this rule will interrupt an active timer and switch to the matched task
- Start timer without asking: if on, tracking starts automatically; if off, you’ll be prompted before the timer starts
- Click Save
Note: In the current version, tracking rules can only be linked to existing tasks.
How it works in practice
Once your rules are configured, Auto-tracker runs silently in the background:
- When a matching window becomes active and stays active beyond your threshold, the timer starts automatically for the linked task
- When you switch to a window matching a different rule, the previous timer stops and the new one begins
- If Stop timer when no activity matches rules is on and you switch to an unmatched window, the timer stops entirely
Example: You have a rule for "Roadmap" set to “any words.” Opening a Notion page titled Roadmap → Prioritization will trigger the rule and begin tracking after 5 seconds.
Tips
- Use “any words” matching for tools like Slack or Notion where window titles change frequently but consistently contain a keyword
- Increase the threshold from the default 5 seconds if you find entries being created from brief tab switches
- Test rules with a short threshold when first setting up, then increase it once you’ve confirmed the rules are triggering correctly
- You can have multiple rules active simultaneously. Auto-tracker applies whichever rule matches the current active window