Skip to content
Zenso Logozenso.inkDocs

Calendar Plugin (zenso-plugin-calendar)

Keep your family or workday schedule visible at a glance without notification dings, glowing monitor tabs, or digital distractions.

Key Features

Section titled “Key Features”
  • Universal iCal Support: Connect Google Calendar, Apple iCloud, Microsoft Outlook, and self-hosted Nextcloud.
  • Multiple Calendar Aggregation: Merge personal, family, and work calendars onto a single screen with color badges.
  • Dynamic Layout Views: Choose between Month Grid, Upcoming Agenda, or Today’s Timeline.
  • Privacy-Preserving: Only the parsed event details required for rendering are retrieved; event descriptions can be masked.

Connecting iCalendar & CalDAV Feeds

Section titled “Connecting iCalendar & CalDAV Feeds”
  1. In Google Calendar or iCloud, locate your calendar’s private/secret .ics address.
  2. In the Zenso Web Panel, open the Calendar widget settings.
  3. Paste the URL into the Feed URL field and assign a friendly label and badge color.

Flexible Layout Views

Section titled “Flexible Layout Views”
  • Agenda View: Chronological list of upcoming events for the next 24 to 72 hours, ideal for split-screen layouts.
  • Month Grid View: Traditional calendar wall-grid with highlighted dates, current-day indicator, and busy dots.
  • Day Timeline: Compact hour-by-hour schedule suitable for work desks.

Colors & Time Formatting

Section titled “Colors & Time Formatting”

Customize the display with standard 12h/24h toggle, hide past events, filter out declined invitations, and configure localized date formats matching your locale.

Developer & Manifest Reference

Section titled “Developer & Manifest Reference”

The plugin parses ICS feeds using ical.js and formats schedules using LiquidJS templates. View the complete source code and contribute at github.com/kstepien3/zenso-plugin-calendar.