Skip to content

1.0.0

Choose a tag to compare

View all tags
@parhamf6 parhamf6 released this 22 Aug 16:26
· 30 commits to main since this release
1.0.0
ba5a08f

Tempo v1.0.0 — Initial Release

Tempo is a modern, minimal time tracker that lives inside your notes. Press play when you start a task, press stop when you finish — that's it. Your time is stored as plain timestamps in your own notes, and a companion stats dashboard turns it into charts, leaderboards, and task percentages.

tempo-demo.mp4

What's in this release

In-note time tracking (tempo block)

  • One-click tracking — insert a tempo code block and press play to start; the button becomes stop while running.
  • Named segments — track as many tasks as you like, rename inline (double-click or the pencil icon), continue past segments, delete mistakes.
  • Nested sub-entries — group segments under parent tasks with tree-style indentation.
  • Survives everything — timers are pure timestamps, so they keep running through note switches, Obsidian restarts, and full shutdowns.
  • Your data stays yours — everything is plain JSON inside your note: no external database, syncs with the rest of your vault.
  • Copy as CSV — one click exports the table to your clipboard.

Stats dashboard (tempo-stats block)

  • Choose your sources — aggregate time from specific folders (optionally recursive, optionally filtered by filename regex) or single files. Nothing is scanned without your say-so.
  • Flexible ranges — Today, last 7/30 days, or any custom range with a date picker.
  • Interactive daily chart — hover any bar for the day's total; click to drill down into that day's tasks, and filter the whole dashboard to just that period.
  • Task leaderboard — ranked per-task totals with a live search filter.
  • Task-percentage breakdown — collapsible donut chart showing each task's share of the period, with an "Other" rollup listing merged items.
  • Always current — refreshes on demand or automatically as your vault changes.
  • CSV export — copy the period's stats for spreadsheets or reports.

Also included

  • Public JavaScript API — query trackers and durations from DataviewJS or other plugins.
  • Configurable — timestamp formats, duration granularity, CSV delimiter, segment order, monospaced timer font, and more.
  • Theme-aware UI — adapts to light/dark modes and your installed theme's palette.

Getting started

  1. Install and enable Tempo (see below).
  2. Run "Tempo: Insert time tracker" from the command palette.
  3. Switch to Live Preview or Reading mode, name your first segment, and press play.
  4. Whenever you want insights, add a tempo-stats block via "Tempo: Insert time tracker stats", pick your sources, and explore.

Installation

Requires Obsidian 1.13.0 or later.

Option A — BRAT

  1. Install and enable BRAT.
  2. Open the command palette and run BRAT: Add a beta plugin for testing.
  3. Enter this repository URL: 
    https://github.com/parhamf6/Tempo
  4. Enable Tempo in Settings → Community plugins.

Option B — Manual

  1. Download main.js, manifest.json, and styles.css from this release.
  2. Create the folder <vault>/.obsidian/plugins/tempo/ (the folder name must match the plugin id) and copy the three files into it.
  3. Restart Obsidian, then enable Tempo in Settings → Community plugins.

Credits & license

Tempo is based on ObsidianSimpleTimeTracker by Ellpeck and includes substantial modifications — most notably the tempo-stats aggregation dashboard, regex folder scanning, and an overhauled UI. Released under the MIT License.

Release assets

  • main.js
  • manifest.json
  • styles.css
Assets 5
Loading