time.md

time.md navigates and visualizes data exported from the time.md screen-time analytics app, directly inside Obsidian.

Drop any time.md export into a folder in your vault and time.md recreates the core time.md experience — Overview, Trends, Calendar, Details, and Apps & Categories views — without needing to open the app.

Supported import formats

time.md auto-detects and parses every format time.md can export:

• JSON (.json) — nested or flat
• CSV (.csv) — with or without metadata comments and section markers
• YAML (.yaml, .yml) — nested sections matching time.md's JSON export shape
• Markdown (.md) — GitHub-flavored tables with metadata header
• Obsidian (.md) — YAML frontmatter payloads used by Obsidian/Bases workflows

Views

Open any view from the command palette (time.md: Open Overview, etc.) or the ribbon icon.

Visualization gallery

The screenshots below are rendered from the plugin's live embed renderer against representative sample data. Every view: value can be used in a timemd code block.

Core screen-time visualizations

Visualization	Embed view	What it shows	Screenshot
Overview dashboard	overview	Stats, trend, weekly heatmap, and top apps in one dashboard.
Stat card	stat	One focused metric such as total time, top app, app count, days, or peak day.
Trend chart	trend-chart / trends	Daily active time line chart.
Weekly heatmap	heatmap / calendar	Weekday × hour activity intensity.
Top apps	top-apps / apps	Ranked app totals with proportional bars.
Categories	categories	Category totals and share of tracked time.
Recent sessions	details	Latest raw sessions with app, timestamp, and duration.

Attention, rhythm, and session analysis

Visualization	Embed view	What it shows	Screenshot
Attention flow	transition-sankey	Sankey diagram showing where focus moves between apps.
App lanes	app-lanes	Per-app timeline lanes for the latest day.
Session waterfall	session-waterfall	Chronological sessions with duration bars.
App rhythm	app-rhythm	App × hour heatmap for daily usage rhythms.
Focus vs fragmentation	fragmentation-scatter	Daily active time versus switches per hour; bubble size is session count.
Category balance	category-balance	Category mix from daily and hourly matrices.
Day archetypes	day-archetypes	Day classifications such as deep work, fragmented, or browsing-heavy.
Contribution heatmap	contribution-heatmap	Calendar-style daily activity heatmap.
Date × hour heatmap	date-hour-heatmap	Raw-session-derived grid by date and hour.

Projects, reports, and browsing

Visualization	Embed view	What it shows	Screenshot
Projects	projects	Category/project list paired with distribution stats.
Distribution donut	distribution	Category share as a donut with legend and stats.
Web history	web-history	Browser history stats, timeline, domains, or hourly activity.
Reports	reports	Summary stats, period comparison, distributions, weekday averages, and export table.

Input tracking visualizations

Visualization	Embed view	What it shows	Screenshot
Input stats	input-stats	Keystrokes, peak typing minute, cursor samples, clicks, and observed apps.
Cursor heatmap	cursor-heatmap	Absolute screen-coordinate cursor heatmap with click overlay.
Typing intensity	typing-intensity	Hourly keystroke line chart.
Top typed keys	top-keys	Most-pressed keys.
Top typed words	top-words	Most-typed words with default redaction controls.
Input activity	input-activity	Per-app click counts from raw mouse events.

Input Tracking

If you've enabled Input Tracking in the time.md app (Settings → Input Tracking), the .input destination emits six new sections that this plugin renders as the Input Tracking view:

Example export workflow

1. In time.md → Export view, pick Destination = Input (or Combined with the input toggles enabled).

2. Pick a format the plugin can read — JSON is recommended for the raw sections:

   Format:      JSON
   Destination: Input
   Date range:  Today
   Sections:    Top Typed Words, Top Typed Keys,
                Cursor Heatmap Bins, Typing Intensity,
                Raw Keystrokes (optional),
                Raw Mouse Events (optional)
   

3. Save the file into the folder you've configured under Settings → time.md → Export folder.

4. Run time.md: Open Input Tracking from the command palette (or click the keyboard ribbon icon).

A minimal JSON export the view can render looks like:

{
  "title": "Input Tracking — 2026-05-04",
  "destination": "input",
  "sections": [
    {
      "name": "input_cursor_heatmap",
      "display_name": "Cursor Heatmap Bins",
      "headers": ["screen_id", "bin_x", "bin_y", "samples"],
      "data": [
        { "screen_id": 1, "bin_x": 30, "bin_y": 22, "samples": 1820 },
        { "screen_id": 1, "bin_x": 31, "bin_y": 22, "samples": 1280 },
        { "screen_id": 2, "bin_x": 60, "bin_y": 20, "samples": 1140 }
      ]
    },
    {
      "name": "input_typing_intensity",
      "display_name": "Typing Intensity",
      "headers": ["timestamp", "keystrokes"],
      "data": [
        { "timestamp": "2026-05-04T10:00:00Z", "keystrokes": 388 },
        { "timestamp": "2026-05-04T11:00:00Z", "keystrokes": 612 },
        { "timestamp": "2026-05-04T15:00:00Z", "keystrokes": 720 }
      ]
    },
    {
      "name": "input_top_keys",
      "display_name": "Top Typed Keys",
      "headers": ["key_code", "key_label", "count"],
      "data": [
        { "key_code": 49, "key_label": "Space",  "count": 1820 },
        { "key_code": 36, "key_label": "Return", "count": 412 },
        { "key_code": 51, "key_label": "Delete", "count": 388 }
      ]
    }
  ]
}

A larger fixture covering all six sections lives at tests/fixtures/input-tracking-sample.json — drop it into your export folder to preview the view without needing real data.

Privacy

• The Top Typed Words and Raw Keystrokes panels default to redacted (each character replaced with •); click Reveal words / Reveal chars to unmask.
• Rows captured while macOS Secure Input was active (e.g. password fields, sudo prompts) are surfaced as 🔒 with empty char values, by design from the time.md exporter.
• If no input sections are present in any loaded export, the Input Tracking view shows an empty-state callout — the existing views are unaffected.

Embedding into notes

Drop a timemd code block into any note to render a live widget that updates whenever you reload exports:

```timemd
view: overview
```

Supported views

Parameters

Examples

Dashboard stat card for a daily note:

```timemd
view: stat
metric: total_time
title: Screen time today
```

Last 7 days of trend:

```timemd
view: trend-chart
days: 7
title: Last week
```

Top 5 apps:

```timemd
view: top-apps
limit: 5
```

Lean overview — stats and apps only, last 7 days:

```timemd
view: overview
sections: stats, apps
days: 7
limit: 3
```

Just yesterday:

```timemd
view: overview
date: yesterday
title: Yesterday
```

Input tracking dashboard for a daily note:

```timemd
view: input-stats
title: Input today
```

```timemd
view: cursor-heatmap
height: 360
```

```timemd
view: top-words
limit: 20
```

A complete sample note that wires every input component together lives at examples/input-tracking.md. The expanded examples/ directory also includes visualization recipes, ready-to-copy note templates, and synthetic exports for previewing dashboards without personal data.

Setup

1. Install the plugin (see "Manually installing" below while it's pre-release).
2. Export data from the time.md app using any supported format.
3. Place the exported file(s) inside a folder in your Obsidian vault.
4. Point the plugin at that folder in Settings → time.md → Export folder.
5. Run time.md: Open Overview from the command palette.

While enabled, the plugin also makes .json, .csv, .yaml, and .yml files visible in Obsidian’s file explorer and opens them in the text editor. Disable Show data files in vault in the plugin settings if you prefer Obsidian’s default file visibility.

Manually installing (pre-release)

1. Build locally: npm install && npm run build
2. Copy main.js, styles.css, manifest.json into <vault>/.obsidian/plugins/timemd-visualizor/
3. Enable the plugin in Obsidian settings.

Development

npm install
npm run dev   # esbuild in watch mode
npm run build # type-check + production build

License

0BSD (same as the sample plugin template).