README file from
GithubTask Hours
Add time estimates (⏱️) to your tasks, see how many hours of work you have today, tomorrow and in the days ahead, and time what you actually spend (⏲). It uses the same format as the Tasks plugin, so the two work together (Tasks isn't required).
Quick entry
Type a symbol in a task line, pick from the suggestions, and it's written in the Tasks format — no emoji typing.
| Type | Adds |
|---|---|
+ |
⏱️ estimate |
@ |
⏳ scheduled date |
$ |
🛫 start date |
! |
📅 due date |
The symbols can be changed in settings.
Sidebar dashboard
Open it from the timer icon in the ribbon. Choose a folder to see estimate totals for Carry-over · Today · Tomorrow · Next 7 / 14 / 30 days · No date, totalled by ⏳ scheduled, 🛫 start or 📅 due date — switch with the buttons at the top. Dates, estimates and checkboxes can be changed right there.
Query blocks
A ```task-hours code block takes the same queries as Tasks, and suggests what you can type next — instructions and folder names — as you write. Task Hours adds estimate instructions such as has estimate and show estimate total. See the Tasks documentation for the query language.
Dates, estimates and priority can be changed in the results, and completing a repeating task creates its next occurrence.
Timer
Tasks with an estimate get ▶ right after ⏱️ — in your notes, in the dashboard and in queries. Click ▶ to start and ■ to stop: the time is written on the task as ⏲️ 26m10s, and turns orange once it passes the estimate.
One timer runs at a time, and the running task shows the time so far (“timing… 12:34”). ⏲ is updated when you stop the timer. The dashboard and queries can total ⏲ too (show actual total in a query).
Installation
From Settings → Community plugins → Browse, search for “Task Hours”.
Manual install: copy main.js, manifest.json and styles.css from the latest release into <vault>/.obsidian/plugins/task-hours/ and enable the plugin.
Privacy
Task Hours works entirely inside your vault and makes no network requests. It reads notes to total your tasks, and only changes a note when you convert quick entry or edit from a Task Hours list.
License
MIT