How liamcain/obsidian-calendar-plugin works
This Obsidian plugin provides a calendar for navigating daily notes, creating missing notes, and visualizing note metadata; optional weekly-note support adds a parallel calendar workflow. The user opens the calendar, selects a day or week, and the view opens an existing note or delegates creation. Calendar metadata sources add writing, task, streak, and tag indicators. The graph reflects the sampled runtime and README capabilities; creation internals and some integration details are represented only at their documented or imported boundaries.
Main entry points: view.ts Calendar view · stores.ts Note and selection stores · index.ts Source registry · main.ts Plugin entry
Components 18
Plugin lifecycle
- Plugin entry
src/main.ts - Plugin settings
src/settings.ts
Calendar interaction
- Calendar view
src/view.ts - Calendar UI
src/ui/Calendar.svelte - Note context menu
src/ui/fileMenu.ts
Note workflows
- Daily note creation
src/io/dailyNotes.ts - Weekly note creation
src/io/weeklyNotes.ts - Creation confirmation
src/ui/modal.ts
Calendar metadata
- Note and selection stores
src/ui/stores.ts - Note presence
src/ui/sources/streak.ts - Tag markers
src/ui/sources/tags.ts - Incomplete tasks
src/ui/sources/tasks.ts - Writing meter
src/ui/sources/wordCount.ts - Metadata utilities
src/ui/utils.ts - Source registry
src/ui/sources/index.ts
Other components
- Obsidian user
- Obsidian host
- Daily notes interface
Connections 29
- Obsidian user → Obsidian host: uses
README.md - Obsidian host → Plugin entry: loads
src/main.ts - Plugin entry → Calendar view: registers view
src/main.ts - Plugin entry → Plugin settings: adds settings
src/main.ts - Obsidian user → Calendar view: navigates calendar
README.md - Calendar view → Calendar UI: renders
src/view.ts - Calendar view → Source registry: imports sources
src/view.ts - Source registry → Note presence: exports source
src/ui/sources/index.ts - Source registry → Tag markers: exports source
src/ui/sources/index.ts - Source registry → Incomplete tasks: exports source
src/ui/sources/index.ts - Source registry → Writing meter: exports source
src/ui/sources/index.ts - Calendar view → Daily note creation: creates daily note
src/view.ts - Calendar view → Weekly note creation: creates weekly note
src/view.ts - Calendar view → Note context menu: shows menu
src/view.ts - Calendar view → Note and selection stores: reads and updates
src/view.ts - Calendar UI → Note and selection stores: reads calendar state
src/ui/Calendar.svelte - Plugin entry → Note and selection stores: subscribes settings
src/main.ts - Plugin settings → Plugin entry: writes options
src/settings.ts - Note and selection stores → Daily notes interface: indexes notes
src/ui/stores.ts - Note presence → Note and selection stores: reads note indexes
src/ui/sources/streak.ts - Tag markers → Note and selection stores: reads note indexes
src/ui/sources/tags.ts - Incomplete tasks → Note and selection stores: reads note indexes
src/ui/sources/tasks.ts - Writing meter → Note and selection stores: reads note indexes
src/ui/sources/wordCount.ts - Note presence → Metadata utilities: uses classes
src/ui/sources/streak.ts - Tag markers → Metadata utilities: partitions tags
src/ui/sources/tags.ts - Writing meter → Metadata utilities: counts and clamps
src/ui/sources/wordCount.ts - Obsidian user → Daily note creation: creates missing note
README.md - Obsidian user → Weekly note creation: opens weekly note
README.md - Daily note creation → Creation confirmation: may confirm