timemd-visualizor

timemd-visualizor for Obsidian

timemd-visualizor 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 timemd-visualizor recreates the core time.md experience — Overview, Trends, Calendar, Details, and Apps & Categories views — without needing to open the app.

Supported import formats

timemd-visualizor 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
• Markdown (.md) — GitHub-flavored tables with metadata header
• Obsidian (.md) — YAML frontmatter + wiki links, fully navigable in place

Views

Open any view from the command palette (timemd-visualizor: Open Overview, etc.) or the ribbon icon.

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 → timemd-visualizor → Export folder.

4. Run timemd-visualizor: 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.

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 → timemd-visualizor → Export folder.
5. Run timemd-visualizor: Open Overview from the command palette.

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).