Obsidian Stats logoObsidian Stats

CalendarPlanner

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

Description

This plugin has not been manually reviewed by Obsidian staff. Calendar Planner that reads from a master file to plan ahead.

Reviews

No reviews yet.

Stats

stars
41
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

Obsidian Calendar Planner

A modified version of the Obsidian Calendar Plugin that reads from a single master planner file instead of individual daily notes.

screenshot-full

Features

  • Single Planner File: All your tasks and events in one planner.md file
  • Calendar View: Visual calendar showing your entries for each day
  • Entry Preview: See actual entry text on calendar days (not just dots)
  • Task Management: Click to view, add, and complete tasks
  • Checkbox Support: Toggle task completion with [ ] and [x] syntax
  • Multi-Day Events: Create entries that span multiple days with date ranges
  • Quick Navigation: Jump directly to any date in your planner file
  • Flexible Date Formats: Supports DD/MM/YYYY and YYYY-MM-DD formats

Installation

  1. Navigate to your Obsidian plugins folder:

    <vault>/.obsidian/plugins/calendar/

  2. Replace the existing main.js with the modified version

  3. Reload Obsidian (Ctrl/Cmd + R) or restart the app

  4. Enable the Calendar plugin in Settings → Community Plugins

Planner File Format

Create a planner.md file in your vault root (or configure a custom path in settings).

Date Headers

Dates can be formatted in several ways:

**21/03/2026**

**2026-03-21**

## 21/03/2026

### 2026-03-21

Entry Types

The plugin supports multiple entry formats:

**21/03/2026**
1) Numbered list item
2) Another numbered item
- Bullet point item
* Another bullet style
- [ ] Incomplete task
- [x] Completed task
[x] Checkbox without bullet
Just plain text (treated as a note)

**22/03/2026**
- [ ] Submit report
- [x] Call dentist
- Meeting at 3pm
1) Review documents
2) Send emails

Multi-Day Events (Date Ranges)

You can create entries that span multiple days using the [from - to] format:

**21/03/2026**
- [ ] Conference trip [21/03 - 23/03]
- [ ] Project deadline [21/03/2026 - 25/03/2026]
1) Holiday [15/03 - 20/03]

Format options:

  • [DD/MM - DD/MM] — Uses the current year
  • [DD/MM/YYYY - DD/MM/YYYY] — Explicit year

Multi-day events will:

  • Appear on all days within the range
  • Show with a highlighted background on the calendar
  • Display a date badge in the modal view

Usage

Viewing the Calendar

  • Click the calendar icon in the left sidebar, or
  • Use the command palette: "Open calendar planner"

Interacting with Days

  • Click a day to open the day modal with all entries
  • Right-click for context menu options
  • Add new entries directly from the modal
  • Click checkboxes to mark tasks complete

screenshot-full

Day Modal Features

  • View all entries for the selected day
  • Checkbox: Click to mark incomplete tasks as done
  • Checkmark (✓): Indicates completed tasks (click to uncheck)
  • Add new entry: Type and press Enter or click Add
  • Multi-day event: Check the box to add from/to dates
  • Date range badge: Shows the span for multi-day events
  • Open Planner File: Jump to that date's section in your planner

Settings

Access via Settings → Calendar Planner

Setting Description Default
Planner file path Path to your master planner file planner.md
Date format Format for dates in your planner DD/MM/YYYY
Max entries per day Number of entries shown on calendar (1-6) 3
Start week on First day of the week Locale default
Show week number Display week numbers column Off

Commands

Available in the command palette (Ctrl/Cmd + P):

  • Open calendar planner - Opens the calendar view
  • Open planner file - Opens your planner.md directly
  • Add entry for today - Quick add via modal

screenshot-full

Calendar Display

Each day cell shows:

  • The day number
  • Up to N entries (configurable)
  • Entry text truncated to fit
  • Completed tasks with strikethrough
  • "+N more" indicator if there are additional entries

Example Workflow

  1. Create planner.md in your vault root:
**15/03/2026**
- [ ] Morning standup
- [ ] Review PRs
- Lunch with team
- [ ] Deploy to staging

**16/03/2026**
1) Doctor appointment 10am
2) Pick up groceries
- [x] Pay rent

  1. Open the calendar view from the sidebar

  2. Click on any day to see full details and manage tasks

  3. Check off tasks as you complete them - they'll update in your planner file

Differences from Original Plugin

Feature Original This Version
Data source Individual daily note files Single planner.md file
Day display Dots indicating content Actual entry text preview
Task completion Via daily note Direct checkbox toggle
Navigation Creates/opens daily notes Opens planner at date section

Troubleshooting

Entries not showing

  • Ensure your date format matches the setting (DD/MM/YYYY vs YYYY-MM-DD)
  • Check that date headers use the correct syntax (**date** or ## date)
  • Verify the planner file path in settings

Checkboxes not detected

Supported formats:

  • - [ ] task or - [x] task
  • * [ ] task or * [x] task
  • [ ] task or [x] task
  • 1) [ ] task or 1) [x] task

Calendar not refreshing

  • Close and reopen the calendar view
  • Reload Obsidian (Ctrl/Cmd + R)

Credits

Based on the Obsidian Calendar Plugin by Liam Cain.

License

MIT License - See original plugin for full license details.

Sponsors