CalDAV Calendar plugin – Display your self-hosted calendar events

[Shadal18]

Here is a CalDAV calendar events plugin which gives a quick view of your local calendar with multiple layout modes.

Repository

• GitHub repository:
  https://github.com/shadal18/inkypi-caldav-calendar

Install

You can install it using the InkyPi plugin installer:

inkypi plugin install caldav_calendar https://github.com/shadal18/inkypi-caldav-calendar

Features

• Connects directly to a CalDAV calendar collection URL
• Works with self‑hosted or NAS‑hosted CalDAV servers
• Supports username/password authentication
• Shows upcoming events in a clean, glanceable format
• Agenda layout for grouped upcoming events
• Focus layout that highlights “now/next” events first
• Week layout for scanning the next several days
• Optional inclusion of all‑day events
• Optional inclusion of ongoing events for today
• Optional day separators between date groups
• Dense mode to fit more data on smaller e‑paper panels
• Color accents tuned for Waveshare 6‑color displays

Details

The plugin connects to your CalDAV server using the full calendar collection URL, username, and password, then pulls events within a configurable “days ahead” window for display on your InkyPi frame.

It focuses on “what’s coming up and when?” visibility from a single calendar rather than multi‑calendar management or editing.

Settings

The settings page lets you configure:

• Calendar URL (CalDAV collection URL)
• Username
• Password
• Title
• Layout mode (Agenda, Focus, or Week)
• Days ahead
• Maximum number of events
• Show or hide all‑day events
• Show or hide ongoing events for today
• Show or hide day separators
• Dense mode for compact layouts

Notes

• Uses a CalDAV server as the data source
• Works well with self‑hosted calendar servers on a local network
• Designed specifically for InkyPi and e‑paper displays, including 6‑color Waveshare panels

Screenshots

• CalDAV Calendar display layouts

• Settings