Obsidian Stats logoObsidian Stats

Day Planner Enhanced

by jagaldol
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. A day planner with an enhanced timeline UI and readable nested schedules. Based on Day Planner 0.30.0.

Reviews

No reviews yet.

Stats

stars
36
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Day Planner Enhanced

Day Planner Enhanced is a community plugin for Obsidian. It adds editable calendar views, basic time-tracking, and an enhanced timeline UI for readable nested schedules.

This plugin is an independent MIT-licensed fork of Obsidian Day Planner.

Day Planner Enhanced is integrated with

Table of contents

Installation

Day Planner Enhanced is listed in Obsidian's community plugin directory and can be installed from Obsidian's built-in community plugin browser.

Before installing, disable the original Day Planner plugin if it is already enabled in the same vault. This fork has its own plugin identity, but it still shares some Day Planner concepts, commands, and view behavior from the upstream codebase.

Install from Obsidian

This is the recommended way to install and update the plugin.

  1. Open Settings → Community plugins in Obsidian.
  2. Select Browse.
  3. Search for Day Planner Enhanced.
  4. Install and enable the plugin.

Manual installation fallback

  1. Open the latest release.

  2. Download these release assets:

    • main.js
    • manifest.json
    • styles.css

  3. Create the plugin folder in your vault:

    <vault>/.obsidian/plugins/day-planner-enhanced/

  4. Put main.js, manifest.json, and styles.css directly inside that folder.

  5. Restart or reload Obsidian.

  6. Enable Day Planner Enhanced in Obsidian's community plugin settings.

Updating

  • If you installed from Obsidian's community plugin browser, update through Obsidian's community plugin settings.
  • If you installed manually, download the latest release assets and replace the existing files in the plugin folder.
  • Restart or reload Obsidian after replacing plugin files.

How to use it

To open the timeline in the sidebar:

  • Either run the command: Show Timeline
  • Or click the timeline icon in the left ribbon

To open multi-day planner:

  • Either run the command: Show multi-day planner
  • Or click on the icon in the left ribbon:

You can overview the upcoming 3 hours in the mini-timeline in the status bar:

If there are remote tasks, the blocks will be colored accordingly.

The plugin can display records from different sources:

  1. Daily notes
  2. Obsidian-tasks
  3. Online calendars
  4. Dataview clock properties

Let's go over each one of them.

1. Showing events from your daily notes

[!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.

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-up

2. tasks community plugin integration, showing events from other files in your vault

You can see tasks anywhere in the vault with dates added by the tasks community plugin. This also works out of the box for all the files in the vault. You only need to add the scheduled property 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).

For example, these tasks will show up in the timeline:

- [ ] #task 08:00 - 10:00 This task uses the shorthand format ⏳ 2021-08-29
- [ ] #task 11:00 - 13:00 This task uses the Dataview property format [scheduled:: 2021-08-29]

3. Showing internet calendars

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.

Where to get a Google Calendar link

[!Warning] Make sure you copy the right link! It should end with .ics, otherwise, you won't see your events!

Google Calendar instructions

Where to get an iCloud link

iCloud Calendar instructions

Where to get an Outlook link

Outlook Calendar instructions

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:

Alternative

If your organization doesn't let you share your calendar this way, you might try a different way described in the upstream project.

4. Time tracking

[!Warning] This feature is experimental and can break or change at any time in the near future. You can help to shape this feature by providing your feedback.

You can record time spent on tasks in the form of Dataview properties and then view the records as time blocks, much like planner entries.

Recording clocks

Start a clock by right-clicking on a task in the editor:

Stop the clock to record the time spent on a task or cancel it to discard the record:

There is a command for each of the menu items, available in the command palette or as a hotkey:

Clocks in timelines

You can enable an additional timeline column to see the recorded clocks next to your planner:

Active clocks

You can see the currently active clocks in the timeline sidebar:

A right click on an active clock will bring the control menu:

Limitations
  • For now clock time blocks are read-only. This is going to be addressed in the future.

Upstream

Day Planner Enhanced is maintained as an independent fork of Obsidian Day Planner. Upstream changes can still be merged from the original project when useful, but this plugin has its own package identity, release versioning, and issue tracker.

Acknowledgements

Sponsors