Time states

Every second the desktop timer runs gets one activity state. States describe what your time was spent on. They are not a score or a judgement of you. This page explains the six states you’ll see, how a day is recorded and how corrections work.

Only the timer bar tracks time. While you work, the app checks your active window every five seconds. The timer sends your time to the server every 30 seconds, and also on each state change and at each full minute, so the dashboard stays up to date.

The six states

• Productive: active work that counts toward your worked time.
• Idle: no keyboard or mouse input for a while (your workspace sets how long in company settings), while you are still inside your shift.
• Break: a longer pause inside your shift, or a break you start with the Break button.
• Overtime: productive time worked outside your shift hours.
• Off-work: idle or break time outside your shift. It is never counted and never sent.
• Offline: the timer is stopped and nothing is tracked. Your teammates see your status based on what is connected: your current state while the desktop app is tracking, “online” if only the web app is open, and offline when nothing is connected.

Your shift decides which labels apply. Inside it, time is productive, idle or break. Outside it, productive time becomes overtime, and idle and break time become off-work. In a Freelancer workspace, which has no shifts, productive time stays regular time and is never labelled overtime.

How a day is stored

A day is stored hour by hour, from hour 0 to hour 23, rather than as one total. Each hour has its own duration and a source, so different hours can come from different places: automatic tracking, a break you started, time your computer was asleep during your shift (counted as break), or a manual edit. Sleep time outside your shift stays untracked, like all off-work time. Automatic entries carry an x-timer-agent marker so they can be told apart from manual edits. The marker never bypasses permission checks: the server still verifies that the record is yours.

Corrections and offline sync

In Automatic mode you can mark the current activity as productive or idle in Settings → Activity Detection. The correction is saved on your device and the local model learns from it right away, so the classifier gets to know the tools you use. This changes how future activity is classified. For how classification works, see Activity classification.

When time recorded offline reaches the server later, the hours are merged. A manual edit or correction always takes precedence over an automatic value; in every other case, the longer duration is kept. That way you lose neither your work nor your corrections.