# Time Tracking — Dondori Docs

> One-key timers, Pomodoro, plan-vs-fact per day, and a push-only Toggl Track mirror.

## Timer

- Select a task and press **P** (with an empty add field) to start the timer; **P** again stops it.
- While a timer runs, the **menu bar ticks** with the elapsed time — visible even with the panel hidden.
- In **focus mode**, right-click the strip for timer / pomodoro / done on the current task.
- One timer at a time: starting a timer on another task stops the previous one.

## Pomodoro

- **⇧P** starts a Pomodoro on the selection — a focus phase followed by a break, with native notifications between phases.
- Pomodoro sessions are recorded with their kind, so you can tell deep-focus intervals from plain wall-clock timing.

## Sessions

Every start/stop pair becomes a **session** on the task. Sessions are listed on the task's detail page, where you can adjust start and end after the fact or delete a stray one.

## Plan vs fact

In the Calendar window, each day's header shows **plan** — the total of scheduled time blocks — next to **fact**, the time actually tracked that day. A scheduled block whose task carries tracked time shows both durations on the block itself.

## Toggl Track mirror

Connect Toggl in **Settings → Integrations** with an API token (setup: https://dondori.io/docs/integrations.md). After that:

- Starting a timer starts a matching Toggl time entry; stopping it stops the entry.
- Mirroring is **push-only and best-effort**: the local session log is the source of truth, and Toggl is a reporting mirror. A failed mirror call never blocks the local timer — it only lights a quiet menu-bar indicator.
