# Timeline View

# Timeline View

The Timeline View shows your entire day as a vertical, color-coded bar. Each block represents an activity, colored by its assigned project. It gives you an instant visual overview of how your time was spent.

If a block represents offline work that was not captured automatically, you can fill the gap with [Manual Time Entry](/docs/trackings/manual-time-entry).

<figure class="my-8 overflow-hidden rounded-2xl border border-white/10 bg-slate-950 shadow-2xl">
  <video
    class="block w-full"
    controls
    muted
    playsinline
    preload="metadata"
    src="/videos/create-manual-time-entry.mp4"
  >
    Your browser does not support the video tag.
  </video>
  <figcaption class="border-t border-white/10 px-4 py-3 text-sm leading-6 text-slate-400 sm:px-5">
    Manual time entry workflow for logging meetings, phone calls, and other offline work.
  </figcaption>
</figure>

---

## Reading the Timeline

- **Vertical axis** — Represents time, flowing from top (start of day) to bottom (end of day)
- **Hour labels** — Displayed along the left edge for quick reference
- **Colored blocks** — Each block is an activity, colored to match its project
- **Gray blocks** — Unassigned activities that haven't been categorized yet
- **Block height** — Taller blocks mean longer activities

The timeline makes it easy to spot patterns — long stretches of focused work, frequent context switches, or gaps in your day.

---

## Hover for Details

Hover over any block to see a popover with:

- **App name** — The application used
- **Window title** — What you were working on
- **Project** — The assigned project (if any)
- **Start and end time** — Exact timestamps
- **Duration** — How long the activity lasted

{/* TODO: Add screenshot */}

---

## Zoom In and Out

<figure class="my-8 overflow-hidden rounded-2xl border border-white/10 bg-slate-950 shadow-2xl">
  <video
    class="block w-full"
    controls
    muted
    playsinline
    preload="metadata"
    src="/videos/pinch-to-zoom.mp4"
  >
    Your browser does not support the video tag.
  </video>
  <figcaption class="border-t border-white/10 px-4 py-3 text-sm leading-6 text-slate-400 sm:px-5">
    Pinch-to-zoom and Cmd + scroll wheel support for scaling the timeline.
  </figcaption>
</figure>

Use the magnifying glass controls, or gesture-based zoom, to adjust the timeline scale:

- **Zoom in** (+) — Expand the timeline to see short activities more clearly
- **Zoom out** (-) — Compress the timeline to see the full day at a glance
- **Pinch to zoom** — Use a two-finger pinch gesture on a trackpad to zoom in or out
- **Cmd + scroll wheel** — Hold `Cmd` while scrolling to zoom the timeline with a mouse or trackpad

{/* TODO: Add screenshot */}

Zooming is useful when you have many short activities clustered together. Zoom in to distinguish them, then zoom out to return to the big picture.

---

## Navigate Between Days

Use the date navigation controls to move between days:

- **Arrow buttons** — Step forward or backward one day at a time
- **Date picker** — Jump to a specific date
- **Today indicator** — A red line marks the current time on today's timeline

The current-time indicator updates in real time, so you can see your day filling in as you work.

---

## Tips

- **Zoom in for short activities** — If you switch apps frequently, zoom in to see each activity clearly
- **Zoom out for the big picture** — Use a wide zoom level to review your full day in one view
- **Look for gray blocks** — Unassigned activities are opportunities to set up [auto-assignment rules](/docs/projects/project-auto-assignment)
- **Use manual entries for gaps** — When the timeline is missing offline work, add it with [Manual Time Entry](/docs/trackings/manual-time-entry)
- **Check for gaps** — Gaps in the timeline might indicate idle time or activities on the [ignore list](/docs/trackings/ignore-tracking)

---

For help, email [support@chronoid.app](mailto:support@chronoid.app)

---

Source: https://www.chronoid.app/docs/timeline/timeline-view