harang-calendar documentation

An Obsidian plugin that shows your CalDAV calendar events directly in your notes and in dedicated calendar views.

Reference a date or a specific event with a dedicated inline syntax; it is rendered as a card widget (a day’s events) or a compact chip (one event) right in the note. A sidebar agenda list and a full-tab month grid give you two more ways to browse events without leaving Obsidian. The plugin is read-only — it never creates, edits, or deletes anything on your CalDAV server.

Contents

• Prerequisites
  • 1. A reachable CalDAV server
  • 2. Obsidian 1.13.4 or later
• Installation
  • Method 1 — Community Plugins (recommended)
  • Method 2 — Manual install of pre-built files
  • Method 3 — Clone the Git repository and build from source
• Usage
  • Adding a CalDAV account
  • Referencing a date or event in a note
  • Scoping a note to one account or calendar
  • Showing a note itself in the calendar views
  • Browsing events: sidebar agenda view
  • Browsing events: full month view
  • Refreshing calendar data
• Architecture
  • Source layout
  • Data flow
  • Reference syntax
  • Note events (harang-date/harang-repeat/harang-time)
  • No runtime dependencies beyond rrule
• Troubleshooting & FAQ
  • “Connection failed” when discovering calendars
  • An event chip looks faded with a dashed border (“unresolved”)
  • A recurring event’s time looks off by an hour around a DST change
  • The plugin doesn’t appear after installing
  • If you installed from source

Indices and tables

• Index

• Search Page