Chrono Notes Calendar

Chrono Notes Calendar is an Obsidian calendar workspace for periodic notes, optional calendar extensions, regional holidays, tasks, statistics, and time-range notes.

Screenshots

Periodic note navigation

Move between adjacent periodic notes, jump to the parent period, or return to the calendar without leaving the note.

Calendar workspace

See note state, tasks, local ICS events, holidays, and range notes together in the month calendar.

Android

The same calendar workspace adapts to touch interaction and narrow screens.

Features

• Year, month, and week calendar views.
• Daily, weekly, monthly, quarterly, and yearly periodic notes.
• Chinese lunar and Ganzhi calendar extensions, including solar terms and traditional festivals.
• Persian (Solar Hijri), Ethiopic, Hebrew, Indian national (Saka), Islamic civil, and Umm al-Qura calendar extensions.
• Mainland China and Singapore holiday extensions.
• Tasks, statistics, heatmaps, time-range notes, templates, and previews.
• Local, read-only ICS calendar sources.
• English, Simplified Chinese, Traditional Chinese, Arabic, Persian, Hebrew, Amharic, and Hindi UI, including right-to-left layout where applicable.

Source notes, calendar files, and plugin settings stay inside the Vault. Chrono Notes Calendar keeps only a derived NoteIndex cache in device-local IndexedDB; that cache is not written into the Vault or sent to a remote service. No account is required.

Getting started

1. Enable the periodic-note types you use and confirm their path patterns in Chrono Notes Calendar settings.
2. Open the calendar from the ribbon or command palette.
3. Optionally enable calendar and holiday extensions or add local ICS sources.
4. Select a date to open or create its periodic note.

Limitations

• ICS sources are local read-only files; remote calendar subscriptions are not fetched directly.
• Holiday availability depends on verified official data. Unpublished future schedules are shown as unavailable rather than predicted.
• Non-Gregorian calendar extensions are backed by the runtime's Unicode calendar data. Gregorian dates remain the note-path, navigation, and indexing anchor; unavailable runtime calendars are omitted safely.
• Some mobile interaction and layout details depend on the Obsidian app and device input stack.

Manual installation

Download chrono-notes-<version>.zip from the latest release and extract it into Vault/.obsidian/plugins/. The archive already contains the chrono-notes/ directory and its three plugin files. Reload Obsidian, then enable Chrono Notes Calendar under Community plugins.

Development

pnpm install
pnpm check

Development requires Node.js 22.13 or later in the 22.x line, or Node.js 24 and later, plus pnpm 11.7.0. See the developer documentation for architecture and testing details.

Questions, usage help, and general feedback are welcome in GitHub Discussions. Please use the structured GitHub issue forms for reproducible bugs and concrete feature requests. Report vulnerabilities only through GitHub's private vulnerability reporting; see the security policy for details. Never post real private Vault paths, note or task content, calendar or ICS data, source URLs, credentials, or personal information publicly.

Acknowledgements

Chrono Notes Calendar draws inspiration from:

• Liam Cain: Calendar
• a-nano-dust (纳米级尘埃): Dust Calendar

中文

查看简体中文说明。