Start timing in one click, record the actual hours, and settle them automatically when a task is done β so you always know exactly how long each task took.
A Pomodoro-style timer for your tasks. Click the β± button on a task row to start, click it again when you are done, and the actual hours are recorded for you β no more filling in timesheets by hand.
The task timer tracks exactly how long every task takes, giving you the data behind your project budgets and efficiency analysis.
In the Gantt task list, find the task you want to time.
Click the β± timer button on the right of the task row and the timer starts.
Once timing starts, the button turns into a red stop button. The linked note opens automatically so you can begin straight away.
When you finish, click the red button to stop. The result is recorded automatically in the task's actualHours field.
While timing runs, the Obsidian status bar at the bottom of the window shows the live information:
For example: β± Timing: IT system upgrade β requirements research | 01:23:45
To stop a single session from running too long (for example when you forget to stop it), the default maximum is 4 hours. Timing stops automatically once the limit is reached.
Open the Task Nexus settings in Obsidian (Settings β Task Nexus).
In the Task Timer section, find the Maximum duration per session option.
Enter the maximum duration in hours and save. It takes effect the next time you start a timer.
When a task is marked complete (- [x]) and it has recorded time, the actual hours are settled automatically and written to the task's actualHours field.
Tick the task off in your note (- [x]), or click the complete button on the Gantt chart.
The plugin writes the accumulated time to the actualHours field and stops the timer as well.
When you click the timer button and the note linked to the task is not open, the plugin opens it for you so you can start work right away.
In the Task Nexus settings pane, the following options affect how the task timer behaves:
| Setting | Description | Default |
|---|---|---|
| Maximum duration per session | Stops a single session that runs too long | 4 hours |
| Open note automatically | Whether to open the linked note when timing starts | On |
| Auto-settle | Whether to settle the timer when a task is completed | On |
| Status bar display | Whether to show timer information in the status bar | On |
| Timer precision | Precision of the recorded result (minutes / seconds) | Minutes |
| Use case | How it helps |
|---|---|
| Work-hour tracking | Record the real time each task takes and generate a monthly time report |
| Project budgeting | Compare planned against actual hours to see how the budget is performing |
| Efficiency analysis | Find out which kinds of tasks take the longest and streamline your workflow |
| Client billing | Bill clients by actual hours, with every entry on record |