Bases Calendar

Calendar and agenda views for Obsidian Bases — group any base by a date property and see your notes on a month grid.

为 Obsidian Bases 提供日历与议程视图。Bases 是官方的数据库式笔记视图，本插件为带日期属性的笔记集合补上时间维度——月历总览、议程列表，与表格/卡片/看板等视图互补。中文说明见下方中文文档。

Features

• Month view — fixed 6-week grid, today highlighted, up to 4 note chips per day (+N more for the rest)
• Agenda view — chronological list of upcoming notes, one click to switch
• Configurable date property — pick any frontmatter property as the date from the view menu (default date)
• Week start — Monday or Sunday
• Flexible date parsing — 2026-01-31, 2026/1/3, 2026.1.3, 20260131, unix timestamps, and moment-like objects
• Notes without a valid date are counted in a footer hint instead of silently disappearing
• Follows your Obsidian light/dark theme (built on theme CSS variables)
• Works on mobile (isDesktopOnly: false)

Install

1. Install from the Obsidian Community plugins browser (Settings → Community plugins → Browse → "Bases Calendar"), or manually copy main.js, manifest.json, styles.css into .obsidian/plugins/bases-calendar/
2. Make sure the core Bases plugin is enabled
3. Open any .base file → view menu → switch the layout to Calendar
4. In the view options, set Date property to the frontmatter property holding your dates

Options

Roadmap

• v0.2: week heatmap, color cards by a second property, expandable +N more popover
• v0.3 (Pro, optional payments): multi-property filters, agenda grouping, custom date chip templates

Privacy

Runs entirely locally. No network requests, no telemetry. Date property values are parsed on your device for rendering only.

中文

为 Obsidian Bases 提供日历与议程视图：把带日期属性的笔记集合显示在月历上，或按日期排成议程列表。

功能

• 月历视图 —— 6 周固定网格，今天高亮，每天最多显示 4 条笔记（其余折叠为 +N more）
• 议程视图 —— 按日期升序列出，顶栏一键切换
• 日期属性可配置 —— 视图菜单中指定任意 frontmatter 属性作为日期（默认 date）
• 周起始日 —— 周一或周日
• 日期解析兼容 —— ISO / 斜杠 / 点分 / 紧凑格式 / 时间戳 / moment 对象
• 无日期笔记在底部计数提示，不会静默丢失；跟随浅色/深色主题；支持移动端

安装

1. 设置 → 第三方插件 → 浏览 → 搜索 Bases Calendar 安装（或手动复制 main.js、manifest.json、styles.css 到 .obsidian/plugins/bases-calendar/）
2. 确保核心插件 Bases 已启用
3. 打开任意 .base 文件 → 视图菜单 → 布局选 Calendar
4. 在视图选项中把 Date property 设为存日期的属性

隐私

本地运行，无网络请求，无遥测。

Development

• Build-free plain JS: edit main.js, copy the three files into your vault's plugin folder — no bundler needed
• Pure-function unit tests: node test/test.js (34 cases: date parsing, leap years, grid building, grouping)
• Integration simulation: node test/sim/run-sim.js (22 assertions against a stubbed Obsidian runtime)
• Lint: npx eslint main.js with the official eslint-plugin-obsidianmd rules

Bases API notes (verified against obsidian-api)

• Data: this.data: BasesQueryResult → .data: BasesEntry[] (also .groupedData / .properties)
• Config: this.config.get(key); register options with type: 'property' for a native property picker
• Values: entry.getValue(propertyId) returns a Value | null (.isEmpty() / .toString()); property ids are prefixed (note.* / file.* / formula.*)
• Open a note: this.app.workspace.getLeaf().openFile(entry.file)
• registerBasesView(viewType, registration); there is no per-view unregister API
• The Bases API has had breaking changes between minors (e.g. 1.12); re-run tests after Obsidian upgrades
• onDataUpdated() can fire frequently — keep rendering light and never retain references to this.data

License

MIT