Chrono Notes Calendar

English · 简体中文

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 with note state, tasks, holidays, local ICS events, and time-range notes.
• Daily, weekly, monthly, quarterly, and yearly periodic notes with built-in or Templater templates.
• Note Navbar navigation between adjacent notes, higher periods, selected dates, and the calendar workspace.
• 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, month and year heatmaps, note previews, task completion, and due-date adjustments.
• Time-range note creation by date-range dragging, cross-week layouts, templates, and a searchable range-note list.
• Local, read-only ICS calendar sources.
• Configurable display formats for Obsidian Date and Date & time properties while preserving ISO YAML, native segmented editing, and optional daily-note opening.
• English, Simplified Chinese, Traditional Chinese, Arabic, Persian, Hebrew, Amharic, and Hindi UI, including right-to-left layout where applicable.

Source notes and plugin settings stay inside the Vault. Read-only ICS sources may be Vault files or explicitly configured local desktop paths; they are never uploaded by the plugin. 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.

Requirements and compatibility

• Obsidian 1.12.7 or later on desktop or mobile.
• Local ICS sources inside the Vault work across supported platforms; explicitly configured paths outside the Vault are desktop-only.
• Optional non-Gregorian calendars depend on the calendar data provided by the Obsidian runtime and are omitted safely when unavailable.

Installation

Manual installation

Download chrono-notes-<version>.zip from the latest release and extract it into Vault/.obsidian/plugins/. The archive contains the chrono-notes/ directory with main.js, manifest.json, and styles.css. Reload Obsidian, then enable Chrono Notes Calendar under Community plugins.

Upgrade

Back up and preserve Vault/.obsidian/plugins/chrono-notes/data.json when it exists. Replace only main.js, manifest.json, and styles.css; delete data.json only when you explicitly want to reset all plugin preferences.

Usage

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.

Settings

Settings cover periodic-note paths and templates, calendar and holiday extensions, task and statistics display, local ICS sources, time-range notes, and Obsidian Date and Date & time property display. Defaults are stored in the plugin's data.json; note content and frontmatter remain in the Vault.

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.

Privacy and security

Chrono Notes Calendar reads Vault notes and user-selected local ICS files through Obsidian or local filesystem boundaries. It does not upload notes, tasks, calendars, or ICS data and does not require an account. Its derived NoteIndex cache stays in device-local IndexedDB and can be rebuilt from the source notes.

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.

Support

• Use General for workflow ideas and general feedback.
• Use Q&A for usage and configuration questions.
• 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.

License

MIT © ZhengYX

Acknowledgements

Chrono Notes Calendar draws inspiration from:

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