kluesn25 downloadsTrack time automatically for every note, PDF and drawing. Live sidebar with start, pause and stop, areas and projects, idle detection, Pomodoro, reminders and manual entries.
Track time automatically for every note, PDF and drawing in your vault. Press Start once – the plugin records how long you work in each document, groups it into areas and projects, and keeps a live overview in your sidebar.
![]()
From the community plugins: Settings → Community plugins → Browse → search for "Automatic Time Tracker" → Install → Enable. You can also open the plugin page and click Install.
Manually: download main.js, manifest.json and styles.css from the latest release, put them into <your vault>/.obsidian/plugins/automatic-time-tracker/ and enable the plugin under Settings → Community plugins.
| Situation | Counted? |
|---|---|
| A note, PDF or drawing is open in the main area and you are active | ✅ for that document |
| Graph view, settings or the overview note are active | ❌ |
| No input for longer than the idle timeout | ❌ (and the idle time is subtracted) |
| Computer is asleep | ❌ |
| You work outside Obsidian | ❌ – add it as a manual entry |
Documents you only opened for less than 30 seconds are summarised instead of listed individually.
By folder (default): each area has one or more folders. The first subfolder below an area folder is the project.
| Area | Folders | Example | Project |
|---|---|---|---|
| University | Uni, Library/Attachments |
Uni/Statistics/Lecture 3.md |
Statistics |
| Work | Work |
Work/Client A/Notes.md |
Client A |
| Other | everything else | Daily notes/2026-11-16.md |
– |
By property: an area property (default area) in a note decides, e.g. area: Work. Files without properties, such as PDFs, fall back to the folder rules.
Project property (optional): for notes that are not inside a project subfolder, the project is read from this property. If its value is a link, the project of the linked note is used.
Turn it on in the live view. Defaults: 25 min work, 5 min break, 15 min long break after 4 rounds – all adjustable.
Besides the live view, the plugin keeps a Markdown note with your totals by area, project, document and day. Every tracked document is linked, so you can jump straight to it.
![]()
![]()
The screenshots show the Mokume theme, made by the same author. The plugin works with any theme and follows Obsidian's light and dark mode. If you like the warm, paper-like look, you can install Mokume under Settings → Appearance → Themes → Manage.
data.json inside your vault's config folder.Start · Pause · Stop (end session) · Start/pause · Open live view · Open overview note · Add time manually · Manage manual entries · Toggle Pomodoro
No hotkeys are set by default – assign your own under Settings → Hotkeys.
The plugin is written in plain JavaScript (src/main.js) and bundled with esbuild:
npm install
npm run build
This creates main.js in the repository root. Copy main.js, manifest.json and styles.css into <your vault>/.obsidian/plugins/automatic-time-tracker/ to test it. Releases are built by a GitHub Actions workflow, which also creates artifact attestations for the release files.
Bugs and ideas: please open an issue.