I work on the plugin in my spare time, and I appreciate any kind of support!
✨ Check out latest updates
🪲 Report bugs and suggest features
❓ Ask questions
👍 Give thumbs up to issues important to you
🪛 Submit pull-requests. If you don't know where to start, create an issue and I'll gladly give you some directions
❤️ Support the project directly:
- Table of contents
- What it looks like
- Drag-and-drop demos
- How to use it
- What else you can do
- Commands
- Note on the old plugin version
- Acknowledgements
Adding time to tasks
Basic editing: create, move, resize (click to expand)
Warning
Dataview (community plugin, see in Obsidian) should be installed and enabled for the plugin to work.
To see the sidebar with a timeline, run the following command: Show the day planner timeline
The plugin has 3 distinct 'modes'. That is, it can display tasks from different sources:
- Daily notes
- Obsidian-tasks
- Online calendars
Let's go over each one of them.
Warning
Either the core 'Daily Notes' (core plugin) or the 'Periodic Notes' (community plugin, see in Obsidian) should be enabled. This is what allows day-planner to 'see' and interact with your daily notes.
This is the most straightforward case that works out of the box: you write your tasks in a daily note and they show up on the timeline:
# Day planner
- [ ] 10:00 - 10:30 Wake up
- [ ] 11:00 - 12:30 Grab a brush and put a little make-upThis mode allows you to see tasks anywhere in the vault with dates added by the tasks community plugin. With this, day-planner serves as a kind of calendar for the tasks plugin.
To make this work,
- Add a tag like
#taskor a folder to the Dataview source field. This is how the plugin knows which files it should monitor:
- Add the tag (
#taskin this example) to the file with some tasks - Add the
scheduledproperty to a task in one of the formats:- Shorthand, added by tasks community plugin:
⏳ 2021-08-29- Note that this plugin has a handy modal for adding these properties
- Full Dataview-like property:
[scheduled:: 2021-08-29] - Another Dataview format:
(scheduled:: 2021-08-29).
- Shorthand, added by tasks community plugin:
Full examples:
---
tags: "#task"
---
- [ ] 08:00 - 10:00 This task uses the shorthand format ⏳ 2021-08-29
- [ ] 11:00 - 13:00 This task uses the Dataview property format [scheduled:: 2021-08-29]To show events from internet calendars like Google Calendar, iCloud Calendar and Outlook you only need to add an ICS link in the plugin settings.
Here's the relevant part:
Under the settings in Outlook on the web, go to Calendar > Shared calendars. Choose the calendar you wish to publish and the level of details that you want others to see.
Here's how the settings look on the web version:
If your organization doesn't let you share your calendar this way, you might try a different way described in this issue.
- 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
- Move multiple tasks at once
- Show the Day Planner Timeline
- Open today's Day Planner
- Show the Week Planner
- Insert Planner Heading at Cursor
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.
- 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
- Thanks to @liamcain for creating daily note utilities and a helpful calendar plugin