NF-Calendar

English · Русский · More plugins by Nomber

A calendar view for Obsidian with built-in daily, weekly and monthly notes and rule-based templates: per weekday, per date, per date range, "last Friday of the month", even/odd weeks and more.

This is a fork of Calendar by Liam Cain, released under the MIT license (see LICENSE). All credit for the original calendar view goes to him; the original README is kept in README.original.md.

• Plugin id: nf-calendar, version 1.0.1
• Requires Obsidian 1.8.7+, works on desktop and mobile
• Interface in English and Russian
• Source and releases: github.com/NOMBER/NF-Calendar

One plugin instead of three

This plugin replaces Calendar + the core Daily Notes plugin + Periodic Notes (weekly / monthly part). It keeps its own settings for daily, weekly and monthly notes and finds and creates the notes itself.

It does not read or enable other plugins, except for the Import from Daily Notes / Periodic Notes button and a one-time import of older settings from those plugins.

Calendar

Click a day to open or create its daily note (Ctrl/Cmd+click opens it in a new pane). Click a week number to open the weekly note.

• Dots under days can mean: the note exists (the default), done tasks, word count, or nothing
• Hover an empty day to preview which template would be used, and the first lines of that file
• Language: Auto / English / Русский (Auto follows Obsidian)

Go to date

Click the month title (for example "Nov 2026") to switch year, pick a month, or type a specific day. Works on mobile too. Right-click the title still opens the main menu.

• A switch chooses whether a month click opens the calendar or that month's statistics
• The day field shows whether the note already exists, then opens or creates it
• Date fields can use DD.MM.YYYY, YYYY.MM.DD, or MM.DD.YYYY (with ., -, or /)

Random daily note

Opens a random existing daily note. In the Go to date dialog, Open random note expands the period options; the dice button opens one immediately with your saved settings.

• Periods: all notes, a year, a month, the last N days, or a date range — you can add several, and the pick uses all of them
• Optional Skip empty (a note with only headings and empty list items counts as empty)
• The command palette item and an optional ⋯ menu item use the same saved settings

Templates

For a daily note the plugin uses, in order: the first matching special rule, then the weekday template, then the default template. Weekly and monthly notes use rules (if enabled for that type) against the first day of the period, then that type's default template.

• Templates are chosen by the note's date, not by today
• One weekday template per day of the week; leave a day empty to use the default
• If a template file is missing, you get a notice and the next candidate is used

Placeholders

All placeholders use the note's date (the first day of the period for weekly and monthly notes):

{{carryover}} (daily notes only) looks back up to 31 days and takes at most 200 tasks. The previous note is not changed. During batch creation it stays empty, so the same tasks are not copied into every future note. Templater's <% … %> is left unchanged.

Special rules

Rules are checked top to bottom. Each has a condition, the note types it applies to (daily / weekly / monthly), and a template file. You can rename, enable, reorder, or delete them. Put more specific rules above broader ones.

• Dates: every year on a day and month (birthdays, holidays), a date range, or a one-off YYYY-MM-DD
• Month: a range of days (1–7, or 25–5 wrapping over the month end), the last N days, first or last day of the month or quarter
• Weekdays and cycles: several weekdays, the N-th weekday of the month (or the last), week N, even or odd ISO week, every N days from a chosen date
• Marks: a holiday from the holidays folder, or a day marked important

Holidays folder

Point the plugin to a folder (for example Meta/Dates) whose note names start with a date. Holidays match every year by day and month.

Supported prefixes include 13.03 Birthday, 03-13 …, 13/03 …, 1999-03-13 - Natalia's birthday, and 1000-09-01 Knowledge Day (the separator after the date is optional). Two-part dates follow the Day first / Month first setting; YYYY-MM-DD is always unambiguous. You can also set a custom pattern (DD_MM, YYYY.MM.DD, …).

• The calendar shows 🎉 on those days; hover to see the names
• Age is shown when the note has a real year (1900 or later); placeholder years like 1000 show no age
• Click the 🎉 mark or use the day's context menu to open the holiday notes
• Holidays also appear in Upcoming and statistics, and can be used as a special-rule condition
• Names that do not start with a recognizable date are counted in settings

Important days

Right-click a day and choose Mark as important… to give it a title, a color, and an optional "prepare N days before" highlight (0–30). A note file is not required.

• Several events can share one day (one color, separate rows in the list)
• A collapsible Upcoming important days list under the calendar opens the note on click
• Filter All / Holidays / Important; right-click (or long-press) a row to complete or dismiss it

The ⋯ menu

The ⋯ button in the calendar header and a right-click on the month title open the same menu. Every action is also a command — assign hotkeys in Obsidian Settings → Hotkeys.

• Place the button left or right of "‹ Today ›", before the month title, on its own row, or hide it (right-click the title still works)
• In Settings → ⋯ menu you can show, hide, and reorder items
• Toggles on the menu turn holiday marks and important-day highlights on or off (display only)

Create missing notes

Commands create missing daily notes until the end of the week or month, for the week back or the whole week, or for a future month shown in the calendar. Existing notes are always skipped and never changed.

• A confirmation lists the dates and the template chosen for each
• You can start from today or from the open daily note
• Right-click a day to create or open that day's note

Apply a template

From the command, the ⋯ menu, or the day's context menu, apply the template that the rules would use for that date.

• An empty note is filled at once
• For a non-empty note you choose: append, insert at the beginning, replace (asks for confirmation), or skip (the default; Esc does the same)

Open today's note on startup

Off by default. When it is on, NF-Calendar opens today's daily note when Obsidian starts, and creates it if needed (without the confirmation dialog). If the note is already open, that tab is focused.

• You can turn the core Daily notes plugin off completely
• If you keep it, turn off its own "Open daily note on startup" option to avoid duplicates

Organize daily notes

From the command palette or Settings → Daily notes, move daily notes into year folders, year+month folders, or back to one flat folder: Daily/2026-10-30.md → Daily/2026/2026-10-30.md.

• Back up your vault before the first run. A preview is shown first; nothing moves until you press Move
• Nothing is overwritten; Obsidian updates links if "Automatically update internal links" is on
• Undo last organize moves the notes back
• You can store new notes in the same layout, and optionally remove empty year/month folders left behind

Statistics

A month view with a table and charts: words, done and open tasks, holidays, and a current all-tasks-done streak. Click a day to open its note.

• ✓ means the note has tasks and all of them are done
• Charts: words per day, done vs open tasks, cumulative words, and a donut of days with ✓ / without ✓ / without a note
• The chosen view, metric, and chart type are remembered

Previous / next daily note

Jumps to the nearest existing daily note before or after the open one. Gaps are skipped and nothing is created.

Installation

The plugin is not yet in the Obsidian community plugin catalog. Install it from GitHub Releases:

0. Upgrading from an earlier test build (plugin id calendar-weekday-templates, named "Calendar (Weekday Templates)"): disable it and delete the folder <your vault>/.obsidian/plugins/calendar-weekday-templates/ first. This release uses the id nf-calendar; settings from the old id are not migrated, so set them again.
1. Download nf-calendar.zip (or main.js, manifest.json and styles.css) from the latest release.
2. Unzip it into <your vault>/.obsidian/plugins/. You should get a folder nf-calendar/ with the three files.
3. Restart Obsidian, or click "Reload plugins" under Community plugins, then enable NF-Calendar.
4. It is best to disable the original Calendar. Once this plugin is set up, Daily Notes and Periodic Notes can be disabled too.

On the first start after an upgrade, the plugin once imports the folder, format, and template from the core Daily Notes and Periodic Notes plugins (if they were configured), plus older weekday templates. After that it no longer reads other plugins' settings. On a fresh install, the import only runs when you click Import from Daily Notes / Periodic Notes.

Templater compatibility

• The plugin does not run Templater code. <% … %> is copied into the new note unchanged. If Templater's "Trigger Templater on new file creation" is on, Templater processes the new note itself.
• After Apply template, run Templater's "Replace templates in the active file" if you need those tags processed.
• In text brought in by {{carryover}}, <% is escaped so Templater does not run it.

Limitations

• Command names in the command palette use the language chosen when the plugin loaded. Reload the plugin after changing the language.
• "Insert at beginning" with a template that has its own frontmatter can produce a second --- block inside the note.
• The Periodic Notes 1.0 beta format (calendar sets) is not supported by the import; Periodic Notes 0.x and the core Daily Notes plugin are.
• Quarterly and yearly notes are not supported.

Security

• Folders, file name formats, and template paths are checked so they cannot point outside the vault or into .obsidian
• The plugin writes only through Obsidian's vault API and does not contact the network
• Existing notes are never overwritten; the only way to change one is Apply template, after you pick an action

More detail is in docs/ARCHITECTURE.md (in Russian).

Development

npm install --legacy-peer-deps
npm run build   # lint (svelte-check, eslint) + rollup -> main.js
npm test        # jest unit tests (src/core/__tests__)
npm run dist    # build + test + dist/ (zip and the three plugin files)

• src/core: logic without Obsidian (templates, dates, rules, settings, stats, i18n), with tests in src/core/__tests__
• src/io: finding, creating, and reading notes
• src/ui: calendar view, menus, settings, and dialogs
• src/main.ts: plugin lifecycle and commands

See docs/ARCHITECTURE.md and CHANGELOG.md. Issues and pull requests are welcome: keep src/core free of Obsidian imports, add tests for logic changes, run npm run build and npm test, and update both languages in src/core/i18n.ts.

License

MIT. See LICENSE. Original Calendar plugin © 2021 Liam Cain; this fork keeps the same license. Author: Nomber.

Support

If this plugin is useful to you, you can support its development:

More plugins by Nomber: nomberobsidian.github.io