Task Hours
mytasklog32 downloadsAdd time estimates to tasks and see total hours by start date, with quick entry like “2h @tomorrow !fri” and a folder dashboard.
- Overview
- Scorecard
- Updates5
Add time estimates to your tasks and see how many hours you've planned — per note, per folder, and per start date.
It uses the same format as the Tasks plugin (🛫 start date, 📅 due date) and adds ⏱️ for the estimate:
- [ ] Draft the proposal ⏱️ 1h30m 🛫 2026-10-06 📅 2026-10-09
Tasks is not required, but the two work well together.
Quick entry
You don't need to type emoji. In a task, type + for the estimate, @ for the start date and ! for the due date. Each one opens a list of suggestions — pick one with ↑↓ and Enter and it's written in the right format straight away:
- [ ] Lunch with Sam +2h @tomorrow !fri
becomes
- [ ] Lunch with Sam ⏱️ 2h 🛫 2026-10-06 📅 2026-10-09
| Type | Means |
|---|---|
+ |
Estimate. + alone lists 15m, 30m, 1h, 2h…; +40 → 40 min; +2 → 2 h; +1.5 → 1 h 30 min; +2h +1h30m +40m as written |
@tomorrow |
Start date |
!fri |
Due date |
@and!suggest dates; you can also choose Pick from calendar….- You can skip the list and just keep typing:
+40 @tomorrowis converted when you press Enter or move to another line. A plain2h,30mor(2h)also counts as an estimate there. - Add
@nextmonto a task that already has a start date to move it (handy for rescheduling). - If something gets converted by mistake, undo with Ctrl/Cmd+Z.
Date words
| You type | Result (if today is Mon, Oct 5) |
|---|---|
today tomorrow (tmr, tmrw) |
Oct 5, Oct 6 |
fri friday |
the next Friday, today included → Oct 9 |
nextfri thisfri nextweek |
Oct 16, Oct 9, Mon Oct 12 |
oct7 7oct 10/7 2026-10-07 |
Oct 7 (a past month/day means next year) |
+3 3d 2w |
Oct 8, Oct 8, Oct 19 |
eom weekend nextmonth |
Oct 31, Sat Oct 10, Nov 1 |
10/7 is read as month/day. If you write day/month, turn on Read short dates as day/month in settings.
What is not converted
@or!right after a letter or digit, such as[email protected].- Words that only start with a date word:
@monica,@tom,@sunnystay as they are. - A lone
2hwhen the task already has ⏱️. Use(3h)to replace it. - Anything inside a code block.
In settings you can turn off automatic conversion or suggestions, change the @ / ! symbols, or require parentheses for estimates.
There's also a form for adding tasks (task name, estimate, start, due), available from the ribbon. It's handy on mobile.
Dashboard
Click the timer icon in the ribbon to open the dashboard in the right sidebar.
- Choose a folder at the top. Pick / (entire vault) to include every note.
- You'll see the total hours and number of open tasks for Carry-over · Today · Tomorrow · Next 14 days · No start date.
- Click a tile to list its tasks. The next days tile is grouped by day with subtotals, and a 7 / 14 / 30 days switch above the list changes its range (remembered for next time).
The folder is remembered, so next time it's one click.
Carry-over shows tasks whose start date has passed but aren't done yet. Change their start date to bring them into today's total.
Edit right from the list
- Click 🛫 start or 📅 due to pick a new date. The task line in the note is updated.
- Click ⏱️ to type a new estimate and press Enter.
- Use the checkbox to complete or reopen a task.
- Click a task name to jump to it in its note.
Totals inside a note
Run the command Show estimate total at top of note to add this block to the top of the current note. It shows the total for the note's open tasks:
```task-hours
show: summary
```
You can also write a query to keep a fixed view in a note. Dates and estimates can be edited from these lists too.
```task-hours
folder: Work
start: this week
group: start
```
| Key | Values | Default |
|---|---|---|
scope |
this (this note) / all (whole vault) |
this |
folder |
folder path, subfolders included (/ = whole vault) |
— |
start |
start date filter (below) | — |
due |
due date filter (below) | — |
status |
open / done / all |
open |
group |
none / start / due / file (with subtotals) |
none |
sort |
start / due / estimate / file |
start |
show |
list / summary (total only) |
list |
limit |
max tasks shown (totals still count all) | — |
Date filters: today tomorrow yesterday · this week next week last week (weeks start Monday) · this month next month · next 7 days · 2026-10-06 · 2026-10-01..2026-10-07 (either side optional) · before today after 2026-10-10 (exclusive) · until 2026-10-10 from today (inclusive) · none (no date) · any (has a date)
Details
[x],[X]and[-](cancelled) count as done.[/]and other statuses count as open.- The start date is 🛫. If a task has no 🛫 but has ⏳ (Tasks' scheduled date), that is used instead.
- Estimate units:
hhrhrshour(s)mminminsminute(s), also時間分. A bare number means hours. - When used with Tasks, ⏱️ must come before 🛫 and 📅. Quick entry, the form, and list edits all place it there for you.
- The interface follows Obsidian's language (English or Japanese). You can override it in settings.
Privacy
Task Hours works entirely inside your vault. It makes no network requests and sends nothing anywhere.
To total tasks across a folder or the whole vault, it lists the Markdown files in your vault and reads the ones that contain tasks. It only changes a note when you ask it to: converting quick-entry text on a task line, or editing a date, estimate or checkbox from a Task Hours list.
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/, then enable the plugin.
Development
npm install
npm run dev # watch
npm run build # production build
License
MIT