Time Tracker Statistics
the-quotient35 downloadsProvides daily and monthly statistics views across your whole vault for the Super Simple Time Tracker by Ellpeck.
- Overview
- Scorecard
- Updates1
This is a statistics companion plugin for the Super Simple Time Tracker by Ellpeck. It provides high-level visualisations for your time tracking data across your entire vault using the Dataview API.
- Visualises tracked time without the need for custom API scripts or coding.
- Identifies the relevant data based on the file's name.
- Daily: Requires a
YYYY-MM-DDformat (e.g.,2026-02-01.md). - Monthly: Requires a year and month index (e.g.,
2026-02.md).
- Daily: Requires a
- Automatically groups tracked entries into categories based on file tags defined in your settings.
- You can add a target time for a category and the breakdown will show you how much you deviated from it. You can very easily mark weekends, public holidays, vacation days and sick days and the deviation calculation will take this into account.
- The Daily view displays whether a tracker is currently running anywhere in your vault.
Different Views
1. Daily Statistics
Provides a summary of all time tracked for a specific calendar day.
- Command:
Insert time tracker statistics day. - Code Block:
simple-time-tracker-statistics-day.
Includes:
- Totals Table: Breakdown of duration, remaining time, and overtime per category based on your set targets.
- Entries Breakdown: A detailed list of every entry, showing the source file and sub-entry hierarchy.
- Running Tracker: Displays a link to any active tracker found in the vault.
2. Monthly Statistics
A comprehensive report grouping entries by week and calculating long-term time balances.
- Command:
Insert time tracker statistics month. - Code Block:
simple-time-tracker-statistics-month.
Managing Time Off
The Monthly view allows you to exclude specific days from your standard work obligations to keep your Accumulated Deviation accurate.
Configuration Parameters
Adjust these values directly within the code block:
| Parameter | Type | Description |
|---|---|---|
deviation |
number |
Time (in milliseconds) to carry over from a previous month. |
vacationDays |
number[] |
Days of the month to be excluded from work targets (e.g., [1, 2, 3]). |
sickDays |
number[] |
Dates marked as sick leave; reduces the work target. |
daysOff |
number[] |
General non-working days (e.g. weekends) or public holidays. |
Setting Up Categories
To make the statistics meaningful, map your vault's tags to categories in the Plugin Settings. The plugin comes pre-configured with two default categories: Work (target 08:00:00) and Leisure (target 00:00:00).
- Define a Category: Give it a name.
- Assign Tags: Add the tags you use to indicate the files associated with the category. By default, Work looks for
#workand Leisure looks for#leisure. - Set Targets: Enter a daily target in
HH:mm:ssformat. If left blank, the target defaults to00:00:00. - Monthly "Work" Tracking: Note: For the Monthly view to calculate deviation, the plugin specifically identifies "Work" by checking for the
#worktag within a category. Ensure your primary work category includes this tag.
Prerequisites
- Simple Time Tracker: Required for the underlying data and API.
- Dataview: Required for the plugin to scan and aggregate data.
Roadmap
- Automate the carry-over of deviation values between months.
- Add yearly summaries. Add yearly summaries.