{"id":13565045,"url":"https://github.com/ivan-lednev/obsidian-day-planner","last_synced_at":"2025-04-03T22:30:33.605Z","repository":{"id":37948703,"uuid":"309622475","full_name":"ivan-lednev/obsidian-day-planner","owner":"ivan-lednev","description":"An Obsidian plugin for day planning with a clean UI and a simple task format","archived":false,"fork":false,"pushed_at":"2024-10-29T09:55:16.000Z","size":12749,"stargazers_count":2081,"open_issues_count":127,"forks_count":500,"subscribers_count":13,"default_branch":"main","last_synced_at":"2024-10-29T11:52:04.786Z","etag":null,"topics":["obsidian-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ivan-lednev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"support-banner.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://www.buymeacoffee.com/machineelf"]}},"created_at":"2020-11-03T08:34:56.000Z","updated_at":"2024-10-29T09:55:21.000Z","dependencies_parsed_at":"2024-01-26T12:12:25.301Z","dependency_job_id":"2312affc-3f6a-458d-8a04-fd90a0cdb9f6","html_url":"https://github.com/ivan-lednev/obsidian-day-planner","commit_stats":null,"previous_names":["lynchjames/obsidian-day-planner"],"tags_count":79,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-lednev%2Fobsidian-day-planner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-lednev%2Fobsidian-day-planner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-lednev%2Fobsidian-day-planner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ivan-lednev%2Fobsidian-day-planner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ivan-lednev","download_url":"https://codeload.github.com/ivan-lednev/obsidian-day-planner/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247089688,"owners_count":20881820,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["obsidian-plugin"],"created_at":"2024-08-01T13:01:39.820Z","updated_at":"2025-04-03T22:30:33.599Z","avatar_url":"https://github.com/ivan-lednev.png","language":"TypeScript","funding_links":["https://www.buymeacoffee.com/machineelf"],"categories":["TypeScript","obsidian-plugin"],"sub_categories":[],"readme":"- 🗳️ [Add '👍' reactions under the issues important to you.](https://github.com/ivan-lednev/obsidian-day-planner/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc) This helps me prioritize my work\n- 🪲 [Report bugs and suggest features](https://github.com/ivan-lednev/obsidian-day-planner/issues)\n- ❓ [Ask questions](https://github.com/ivan-lednev/obsidian-day-planner/discussions/new?category=q-a)\n- 🛠️ [Submit pull-requests](./CONTRIBUTING.md)\n- ❤️ If this project adds value to your life, consider supporting it finantially:\n  - \u003ca href=\"https://www.buymeacoffee.com/machineelf\" target=\"_blank\"\u003e\u003cimg src=\"https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png\" alt=\"Buy Me A Coffee\" style=\"height: 60px !important;width: 217px !important;\" \u003e\u003c/a\u003e\n\n\nDay Planner is a community plugin for [Obsidian](https://obsidian.md/). It adds editable calendar views and basic time-tracking. Day Planner is integrated with\n\n- The core Daily Notes plugin.\n- [the Tasks plugin](https://obsidian.md/plugins?id=obsidian-tasks-plugin)\n- Online calendars\n\n## Table of contents\n\n- [Table of contents](#table-of-contents)\n- [How to use it](#how-to-use-it)\n  - [1. Showing events from your daily notes](#1-showing-events-from-your-daily-notes)\n  - [2. tasks community plugin integration, showing events from other files in your vault](#2-tasks-community-plugin-integration-showing-events-from-other-files-in-your-vault)\n  - [3. Showing internet calendars](#3-showing-internet-calendars)\n    - [Where to get a Google Calendar link](#where-to-get-a-google-calendar-link)\n    - [Where to get an iCloud link](#where-to-get-an-icloud-link)\n    - [Where to get an Outlook link](#where-to-get-an-outlook-link)\n      - [Alternative](#alternative)\n  - [4. Time tracking](#4-time-tracking)\n    - [Recording clocks](#recording-clocks)\n    - [Clocks in timelines](#clocks-in-timelines)\n    - [Active clocks](#active-clocks)\n    - [Limitations](#limitations)\n- [Note on the old plugin version](#note-on-the-old-plugin-version)\n- [Acknowledgements](#acknowledgements)\n\n## How to use it\n\n\u003e [!Warning]\n\u003e Dataview (community plugin, [see in Obsidian](obsidian://show-plugin?id=dataview)) should be installed and enabled for the plugin to work.\n\nTo open the timeline in the sidebar:\n\n- Either run the command: `Show Timeline`\n- Or click the timeline icon in the left ribbon\n  - ![](./assets/open-timeline-ribbon-icon.png)\n\nTo open multi-day planner:\n\n- Either run the command: `Show multi-day planner`\n- Or click on the icon in the left ribbon:\n  - ![](./assets/open-multi-day-view-ribbon-icon.png)\n\nThe plugin has 4 distinct 'modes'. That is, it can display records from different sources:\n\n1. Daily notes\n2. Obsidian-tasks\n3. Online calendars\n4. Dataview clock properties\n\nLet's go over each one of them.\n\n### 1. Showing events from your daily notes\n\n\u003e [!Warning]\n\u003e Either the core 'Daily Notes' (core plugin) or the 'Periodic Notes' (community plugin, [see in Obsidian](obsidian://show-plugin?id=periodic-notes)) should be enabled. This is what allows day-planner to 'see' and interact with your daily notes.\n\nThis works out of the box: you write your tasks in a daily note, and they show up on the timeline:\n\n```md\n# Day planner\n\n- [ ] 10:00 - 10:30 Wake up\n- [ ] 11:00 - 12:30 Grab a brush and put a little make-up\n```\n\n### 2. [tasks community plugin](obsidian://show-plugin?id=obsidian-tasks-plugin) integration, showing events from other files in your vault\n\nThis mode allows you to see tasks anywhere in the vault with dates added by the [tasks community plugin](obsidian://show-plugin?id=obsidian-tasks-plugin).\n\nTo make this work,\n\n1. Add a tag like `#task` or a folder to the Dataview source field:\n   ![](./assets/dv-source.png)\n1. Add the tag (`#task` in this example) to the file with some tasks\n1. Add the `scheduled` property to a task in one of the formats:\n   - Shorthand, added by [tasks community plugin](obsidian://show-plugin?id=obsidian-tasks-plugin): `⏳ 2021-08-29`\n     - Note that this plugin has a handy modal for adding these properties\n   - Full Dataview-like property: `[scheduled:: 2021-08-29]`\n   - Another Dataview format: `(scheduled:: 2021-08-29)`.\n\nFull examples:\n\n```md\n- [ ] #task 08:00 - 10:00 This task uses the shorthand format ⏳ 2021-08-29\n- [ ] #task 11:00 - 13:00 This task uses the Dataview property format [scheduled:: 2021-08-29]\n```\n\n\u003e [!Note]\n\u003e For now, the tags work at the level of files. So if `#task` is found anywhere in the file, all the tasks are going to be pulled into the calendar.\n\n### 3. Showing internet calendars\n\nTo show events from internet calendars like **Google Calendar, iCloud Calendar and Outlook** you only need to add an ICS link in the plugin settings.\n\n![](./assets/ical-settings-demo.png)\n\n#### Where to get a Google Calendar link\n\n\u003e [!Warning]\n\u003e Make sure you copy the right link! It should end with `.ics`, otherwise, you won't see your events!\n\n[Google Calendar instructions](https://support.google.com/calendar/answer/37648?hl=en#zippy=%2Csync-your-google-calendar-view-edit%2Cget-your-calendar-view-only)\n\n#### Where to get an iCloud link\n\n[iCloud Calendar instructions](https://www.souladvisor.com/help-centre/how-to-get-icloud-calendar-address-on-mac-in-ical-format)\n\n#### Where to get an Outlook link\n\n[Outlook Calendar instructions](https://support.microsoft.com/en-us/office/introduction-to-publishing-internet-calendars-a25e68d6-695a-41c6-a701-103d44ba151d?ui=en-us\u0026rs=en-us\u0026ad=us)\n\nHere's the relevant part:\n\n\u003e Under the settings in Outlook **on the web**, go to Calendar \u003e Shared calendars. Choose the calendar you wish to publish and the level of details that you want others to see.\n\nHere's how the settings look on the web version:\n![](./assets/outlook-guide-1.png)\n\n##### Alternative\n\nIf your organization doesn't let you share your calendar this way, you might try [a different way described in this issue](https://github.com/ivan-lednev/obsidian-day-planner/issues/395).\n\n### 4. Time tracking\n\n\u003e [!Warning]\n\u003e 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.\n\nYou can record time spent on tasks in the form of Dataview properties and then view the records as time blocks, much like planner entries.\n\n#### Recording clocks\n\nStart a clock by right-clicking on a task in the editor:\n\n\u003cimg src=\"./assets/clock-in-demo.png\" width=\"75%\"\u003e\n\nStop the clock to record the time spent on a task or cancel it to discard the record:\n\n\u003cimg src=\"./assets/clock-out-demo.png\" width=\"75%\"\u003e\n\nThere is a command for each of the menu items, available in the command palette or as a hotkey:\n\n\u003cimg src=\"./assets/clock-commands-demo.png\" width=\"75%\"\u003e\n\n#### Clocks in timelines\n\nYou can enable an additional timeline column to see the recorded clocks next to your planner:\n\n\u003cimg src=\"./assets/show-time-tracker-settings.png\" width=\"75%\"\u003e\n\n#### Active clocks\n\nYou can see the currently active clocks in the timeline sidebar:\n\n\u003cimg src=\"./assets/active-clocks-demo.png\" width=\"75%\"\u003e\n\nA right click on an active clock will bring the control menu:\n\n\u003cimg src=\"./assets/active-clocks-menu.png\" width=\"75%\"\u003e\n\n#### Limitations\n\n- For now clock time blocks are read-only. This is going to be addressed in the future.\n\n## Note on the old plugin version\n\n0.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](https://github.com/ivan-lednev/obsidian-day-planner/issues).\n\nIf for some reason you still want to use the old version, there are community forks, which you can use via [BRAT](https://github.com/TfTHacker/obsidian42-brat). [Here is one such fork](https://github.com/ebullient/obsidian-day-planner-og).\n\n## Acknowledgements\n\n- Thanks to [Michael Brenan](https://github.com/blacksmithgu) for Dataview\n- Thanks to [James Lynch](https://github.com/lynchjames) for the original plugin\n- Thanks to [Joshua Tazman Reinier](https://github.com/joshuatazrein) for his plugin that served as an inspiration\n- Thanks to @liamcain for creating daily note utilities and a helpful calendar plugin\n- Thanks to [Emacs Org Mode](https://orgmode.org/) for an idea of text-based time-tracking\n- Thanks to [Toggl Track](https://track.toggl.com/timer) for an idea of a great time-tracking UI\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-lednev%2Fobsidian-day-planner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fivan-lednev%2Fobsidian-day-planner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fivan-lednev%2Fobsidian-day-planner/lists"}