• ✨ Check out new features and other changes

• 🪲 Create issues

• 🪛 Submit pull-requests

• ❤️ Support directly:

  

Table of contents

• Table of contents
• What it looks like
• Drag-and-drop demos
• How to use it
  • Dataview integration
    • How to schedule a task anywhere in the vault
    • Dataview source filter
• What else you can do
• Commands
• Note on the old plugin version
• Acknowledgements

What it looks like

Drag-and-drop demos

Adding time to tasks

Basic editing: create, move, resize (click to expand)

Advanced editing: copy, move/resize with neighbors (click to expand)

How to use it

1. Either the core 'Daily Notes' or the 'Periodic Notes' plugins should be enabled
2. The Dataview plugin should be enabled
3. Install the plugin
4. Open timeline view to monitor your progress with the command: Show the day planner timeline or by clicking on the ribbon icon

Dataview integration

A task is going to show up in the timeline for a given day

• If it's inside a daily note for the day
• Or if it's scheduled for the day

Everything Dataview recognizes as a task is shown in the timeline, including:

• Tasks inside callouts
• Nested tasks. If a nested task has a timestamp, it'll show up as a separate block, and will be excluded from its parent's unscheduled sub-items list

How to schedule a task anywhere in the vault

To schedule a task add time and a date that Dataview recognizes: ⏳ 2021-08-29 or [scheduled:: 2021-08-29] or (scheduled:: 2021-08-29).

Full examples:

- [ ] 08:00 - 10:00 This task uses the shorthand format (used by obsidian-tasks) ⏳ 2021-08-29
- [ ] 11:00 - 13:00 This task uses the Dataview property format [scheduled:: 2021-08-29]

obsidian-tasks adds a modal with some handy shortcuts for adding dates like these.

Dataview source filter

You can set up Dataview to search for tasks only in specific folders or tags. This improves performance on large vaults. Here are the docs on how to use the syntax.

What else you can do

• Observe your progress in the status bar
• Use the week view for multi-day planning
• Color tasks based on time
• Click on the timeline to create tasks
• Drag tasks to re-schedule
• Copy tasks by holding Shift while dragging (note: right now, only single line tasks are supported)
• Move multiple tasks by holding Control while dragging/resizing

Commands

• Show the Day Planner Timeline
• Open today's Day Planner
• Show the Week Planner
• Insert Planner Heading at Cursor

Note on the old plugin version

0.7.0 significantly changes what the plugin looks like and what it does. If you like to have some of the old behaviors back, consider creating an issue.

If for some reason you still want to use the old version, there are community forks, which you can use via BRAT. Here is one such fork.

Acknowledgements

• Thanks to James Lynch for the original plugin
• Thanks to replete, whose fork I initially forked
• Thanks to Michael Brenan for Dataview
• Thanks to Joshua Tazman Reinier for his plugin, which gave me an idea of how to integrate with Dataview