# Prisma Calendar ![Downloads](https://img.shields.io/github/downloads/Real1tyy/Prisma-Calendar/total?label=Downloads&style=for-the-badge&color=238636) ![Release](https://img.shields.io/github/v/release/Real1tyy/Prisma-Calendar?label=Latest%20Release&style=for-the-badge&color=1f6feb) ![Stars](https://img.shields.io/github/stars/Real1tyy/Prisma-Calendar?style=for-the-badge&color=f0c830) [![Product Page](https://img.shields.io/badge/Product_Page-8957e5?style=for-the-badge)](https://matejvavroproductivity.com/tools/prisma-calendar/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_product_page) [![Documentation](https://img.shields.io/badge/Documentation-238636?style=for-the-badge)](https://prisma-calendar.matejvavroproductivity.com/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_documentation) [![Install in Obsidian](https://img.shields.io/badge/Install_in_Obsidian-7c3aed?style=for-the-badge&logo=obsidian&logoColor=white)](https://community.obsidian.md/plugins/prisma-calendar) [![Changelog](https://img.shields.io/badge/Changelog-0969da?style=for-the-badge)](https://prisma-calendar.matejvavroproductivity.com/changelog/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_changelog) ## **Turn any note with a date into a flexible planning system inside Obsidian.** There are no rigid schemas or predefined structures โ€” just your data, your rules, fully under your control. Prisma lets you see your entire vault through time.
Prisma Calendar Preview

๐Ÿ“… Calendar for Your Notes
Turn Markdown notes with a date into draggable events in month, week, day, list, and timeline views.		 ๐Ÿ“ Plan Projects & Deadlines
Map project notes into timelines, milestones, dependencies, and Gantt-style plans.		 ๐Ÿ” Recurring Notes & Habits
Daily, weekly, monthly, or custom recurring notes โ€” track patterns with a heatmap and stats on streaks, skips, and intervals.
๐Ÿ—“๏ธ Meetings with Context
Schedule meetings as notes with agendas, links, prep, decisions, and follow-ups.		 โฑ๏ธ Time Tracking & Capacity
Track planned vs actual time and see workload, remaining capacity, and category breakdowns.		 ๐Ÿ”’ Local-First Planning
Keep everything as plain Markdown in your vault โ€” no migration, cloud lock-in, or new app.
---
๐Ÿ“‘ Table of Contents - [Quick Start โ€” See Prisma in Action](#๏ธ-quick-start--see-prisma-in-action) - [How Does It Work?](#how-does-it-work) - [Why Prisma?](#why-prisma) - [Four Views Through Time](#four-views-four-ways-to-see-your-vault-through-time) - [What Makes Prisma Different](#what-makes-prisma-different) - [Gallery & Documentation](#-gallery--documentation) - [The Complete Encyclopedia](#-go-deeper--the-complete-encyclopedia) - [Free vs Pro](#free-vs-pro) - [Why Pro?](#why-pro) - [Frequently Asked Questions](#frequently-asked-questions) - [Installation](#-installation) - [Support & Sponsorship](#support--sponsorship) - [Third-Party Independence](#third-party-independence) - [Privacy & Telemetry](#privacy--telemetry) - [License](#license) - [Credits & Acknowledgments](#credits--acknowledgments)
--- ## โ–ถ๏ธ Quick Start โ€” See Prisma in Action
Prisma Calendar โ€” Quick Start ๐Ÿ‘‰ **[Install Prisma Calendar in Obsidian](https://community.obsidian.md/plugins/prisma-calendar)** โ†’ follow the Quick Start โ†’ create your first event in under 2 minutes.
--- ## How Does It Work? Prisma reads notes inside a folder you choose and turns them into events based on their frontmatter properties: - **Start / End** โ€” datetime values for timed events (e.g. `Start: 2025-06-15T09:00`) - **Date** โ€” a date value for all-day events (e.g. `Date: 2025-06-15`) You choose which property names Prisma should look for during setup. If you already have notes with date-like properties, Prisma picks them up and visualizes them automatically โ€” no migration, no restructuring, no new system to learn. ```yaml --- Start: 2025-06-15T09:00 End: 2025-06-15T10:30 AllDay: false Status: In Progress Project: Q1 Planning --- Meeting agenda, notes, links โ€” any content you want. ``` Every event is a regular Obsidian note. You can open it, write inside it, link to other notes, and use it like any other file in your vault. Prisma doesn't own your data โ€” it just visualizes what's already there. --- ## Why Prisma?
**Unlike Google Calendar** You're not locked into someone else's structure. Prisma works with your own markdown fields and custom metadata โ€” fully inside your vault. **Unlike Notion** No cloud dependency. No lag. No proprietary format. Just your data, local and under your control. **Unlike other calendar plugins** Not just basic navigation โ€” full planning system, recurrence, dependencies, batch operations, and multi-view planning.
--- ## Four Views. Four Ways to See Your Vault Through Time.
### ๐Ÿ“… Calendar Year, month, week, day, and list views for daily scheduling. Drag events, resize durations, create directly on the grid. ### ๐Ÿ“Š Timeline Horizontal sequencing โ€” see how events flow across days and weeks. Perfect for project phases and deadlines.
### ๐Ÿ”ฅ Heatmap Pro GitHub-style contribution view. Spot patterns, gaps, and consistency at a glance across months or years. ### ๐Ÿ“ Gantt Pro Dependency-aware project planning. Link tasks with prerequisites and visualize the critical path.
> [!TIP] > **Start simple.** You don't need all four views on day one. Begin with the Calendar view and explore from there. Prisma is designed to grow with your system โ€” start with the basics and go deeper when you're ready. --- ## What Makes Prisma Different > **You don't need all of this to get started.** Start with the Calendar view and basic events โ€” everything else can be explored over time. ### Configure Everything Other tools force their workflow on you. Prisma adapts to yours. Map your own frontmatter properties, define JavaScript-powered color rules, set up advanced filters, and customize the appearance down to event text, icons, and density. Run **multiple independent planning systems** โ€” each with their own settings and folder scope. ### Fully Reactive There's no "restart Obsidian to apply changes" here. Every setting change, every color rule tweak, every filter adjustment takes effect **immediately**. Edit a note's frontmatter and watch the calendar update in real time. ### Undo and Redo Everything Made a mistake? Hit undo. Changed your mind? Redo. Every action โ€” creating, editing, moving, deleting, batch operations โ€” is tracked in a full history. You'll see exactly what's being reversed, so you're always in control. ### Recurring Events That Generate Real Notes Most calendar plugins show recurring events as ephemeral entries. In Prisma, recurring events create **actual Obsidian notes** โ€” one per instance, fully linked back to the source. Define a frequency (daily, weekly, bi-weekly, monthly, custom) and Prisma handles the rest. Virtual previews show future instances without cluttering your vault. ### Batch Operations Managing 50 events one by one? No. Select multiple events and delete, duplicate, move, clone, skip, or open them โ€” all at once. Shift entire weeks forward or backward. ### Smart Categories Define categories with color coding, then let Prisma **auto-assign them** based on event names. Title autocomplete keeps naming consistent and prevents typos. Categories also power event group aggregation, giving you a bird's-eye view of related events across your entire planning system. ### Statistics and Time Insights See where your time actually goes. Pie charts, category breakdowns, and detailed tables โ€” filterable by day, week, month, or all time. Recurring series get their own statistics so you can track consistency and trends over time. ### Built-in Notifications Set up reminders and get notified directly inside Obsidian โ€” no external tools needed. ### Time Tracker Start and stop a timer from any event modal. Track actual time spent vs planned durations and build a real picture of how your time is used. ### Event Presets and Templates Create reusable presets with pre-filled frontmatter so you can spin up new events in seconds. Pair with Templater for template-driven workflows. ### Scriptable via API Prisma exposes a programmatic API โ€” create, modify, and query events from scripts, Templater templates, or other plugins. Automate workflows and integrate your planning system into your broader Obsidian setup. ### CalDAV and ICS Sync Connect your external calendars. Sync with Fastmail, Nextcloud, iCloud, Google Calendar, Outlook, and any CalDAV/ICS-compatible service. Synced events become real Obsidian notes with full frontmatter โ€” no black-box sync, just your data in your vault. ### Tabbed Views Switch between Calendar (year/month/week/day/list), Timeline, Daily+Stats, and Dual Daily โ€” all in a persistent tabbed container. Pro adds Heatmap, Gantt, and Dashboard. Zoom time slots from 1 to 60 minutes. Display frontmatter properties directly inside event chips. ### 55+ Header Actions One-click shortcut buttons for any command โ€” fully customizable. Reorder, rename, change icons and colors, or hide actions via the gear button. ### Capacity Tracking See at a glance how full your schedule is โ€” used vs total hours with remaining time and auto-inferred boundaries. ### Global Event Management Browse, search, and manage all events across all planning systems from a single interface. Auto-group events by recurring rule, category, or name. --- ## ๐Ÿ“ธ Gallery & Documentation [![View Gallery](https://img.shields.io/badge/View_Gallery_โ†’-1f6feb?style=for-the-badge)](https://prisma-calendar.matejvavroproductivity.com/gallery?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_gallery) [![View Full Documentation](https://img.shields.io/badge/View_Full_Documentation_โ†’-238636?style=for-the-badge)](https://prisma-calendar.matejvavroproductivity.com/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_documentation) [Installation](https://prisma-calendar.matejvavroproductivity.com/installation?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_installation) โ€ข [Quickstart](https://prisma-calendar.matejvavroproductivity.com/quickstart?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_quickstart) โ€ข [Configuration](https://prisma-calendar.matejvavroproductivity.com/configuration?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_configuration) โ€ข [Features Overview](https://prisma-calendar.matejvavroproductivity.com/features/overview?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_features_overview) โ€ข [FAQ](https://prisma-calendar.matejvavroproductivity.com/faq?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_faq) โ€ข [Troubleshooting](https://prisma-calendar.matejvavroproductivity.com/troubleshooting?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_troubleshooting) --- ## ๐ŸŽฌ Go Deeper โ€” The Complete Encyclopedia
Prisma Calendar โ€” The Complete Encyclopedia Every feature broken down from A to Z โ€” views, events, recurrence, time tracking, categories, color rules, batch operations, filtering, integrations, AI, the API, and every setting. A full walkthrough and a long-term reference you can come back to anytime. **[YouTube Playlist โ†’](https://www.youtube.com/playlist?list=PLMVJknbUasLCULubO4MdCDvg9MyXu3kG4&utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_playlist)** All Prisma Calendar videos.
--- ## Free vs Pro Prisma follows a freemium model โ€” **all core features are completely free.** No account, no trial required, no limitations on the core experience. Just install and go. For more connected, advanced workflows, **Prisma Pro** unlocks calendar synchronization, advanced visualizations, Bases integration for embedding views directly inside notes, and other power-user capabilities built for serious planning inside Obsidian. **Try every Pro feature with a 30-day free trial. Cancel anytime.** [![Start Free Trial](https://img.shields.io/badge/Start_Free_Trial_โ†’-238636?style=for-the-badge)](https://matejvavroproductivity.com/tools/prisma-calendar/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_free_trial)
What you get for free
Tabbed view navigation (Calendar, Timeline, Daily+Stats, Dual Daily), 55+ customizable header actions, up to 3 independent planning systems, up to 2 event presets, recurring events (9 types + custom intervals with real note generation), 50-action undo/redo, 10+ batch operations, built-in time tracker, capacity tracking, statistics dashboard, event groups, JavaScript color rules, advanced filtering with saved presets, desktop notifications, holidays (50+ countries), title autocomplete, auto-assign categories, untracked events inbox, ICS import/export, and 60+ hotkeys.
What Pro adds
AI Chat (Claude & GPT), Heatmap View, Dashboard, Gantt View, Bases Calendar View, Prerequisite Connections, CalDAV & ICS URL Sync, Programmatic API, Custom Category Presets, Unlimited Planning Systems, Unlimited Event Presets, and Priority Support. **[Learn more about Free vs Pro โ†’](https://prisma-calendar.matejvavroproductivity.com/features/free-vs-pro?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_free_vs_pro)**
--- ## Why Pro? **"Why should I pay for an Obsidian plugin?"** Fair question. Here's the honest answer. Prisma is fully free and feature-rich out of the box. You can use it forever without paying a cent. Pro exists for users who want to go deeper โ€” external calendar sync, Gantt charts, heatmaps, AI features, the scripting API, and more. But there's a bigger reason Pro matters. There's a well-known pattern in the Obsidian ecosystem: a developer builds a great plugin, it gets popular, and then slowly gets abandoned. Life gets busy. Updates slow down. Bugs pile up. Eventually the plugin goes silent. That happens because maintaining a complex plugin takes serious, ongoing time โ€” and most developers can't justify spending 20+ hours a week on something that doesn't pay the bills. Pro breaks that cycle. Every Pro license directly funds full-time development of Prisma. It means I can prioritize this work, ship improvements consistently, fix bugs fast, and build the features you ask for. This isn't a side project. It's my work. Pro is what makes that sustainable โ€” for me and for everyone who uses Prisma, free or paid. If you rely on Prisma, Pro ensures it keeps improving โ€” consistently and long-term. > [!NOTE] > I regularly publish update videos, and every change is documented in the [changelog](https://prisma-calendar.matejvavroproductivity.com/changelog?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_changelog). Prisma is under active, full-time development. --- ## Frequently Asked Questions
Is my data safe?
Prisma is 100% local-first. Your notes stay in your vault โ€” nothing is uploaded, synced to my servers, or shared with anyone. There is zero client-side telemetry. The only server communication is Pro license verification, and if you use the free version, no data leaves your machine at all.
Will it work with my existing notes?
Yes. Prisma is schema-agnostic โ€” it reads whatever frontmatter properties you already use. You tell it which fields represent your start date, end date, categories, and so on. No migration, no restructuring, no predefined schemas required.
Is it hard to set up?
Install it, point it at a folder, map your frontmatter fields โ€” that's it. Most users are up and running in under 5 minutes. The [Quick Start video](#%EF%B8%8F-quick-start--see-prisma-in-action) above walks you through the entire process.
Does it work on mobile?
Yes. Core features work on mobile with a responsive design. I'm continuously improving the mobile experience based on user feedback.
Can I sync with Google Calendar, Outlook, or Apple Calendar?
Yes โ€” through CalDAV and ICS integration. You can sync with Google Calendar, Outlook, Apple Calendar, iCloud, Fastmail, Nextcloud, and any service that supports CalDAV or ICS. Synced events become real Obsidian notes with full frontmatter. Automatic sync requires a Pro license, but you can also import and export `.ics` files manually for free.
What happens if I stop paying for Pro?
All free features keep working exactly as before. Pro features (Gantt, Heatmap, AI, CalDAV sync, etc.) deactivate, but nothing is deleted or lost. You can reactivate anytime.
Will it slow down Obsidian?
No. Prisma is built for performance and handles vaults with thousands of notes. The reactive engine only processes changes โ€” it doesn't re-scan everything on every edit.
Is my data locked into Prisma's format?
No. Events are plain Markdown notes with standard YAML frontmatter. If you ever uninstall Prisma, your notes remain exactly as they are โ€” readable, searchable, and usable by any other tool or plugin.
--- ## ๐Ÿ“ฆ Installation The fastest way is to open the [Prisma Calendar Community Plugin page](https://community.obsidian.md/plugins/prisma-calendar) and click **Add to Obsidian** โ€” Obsidian opens to Prisma's listing in the Community Plugins store, where you click **Install** and then **Enable**. Alternatively, inside Obsidian go to **Settings โ†’ Community plugins โ†’ Browse**, search **"Prisma Calendar"**, then click **Install** and **Enable**. See the [Installation Guide](https://prisma-calendar.matejvavroproductivity.com/installation?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_installation_guide_inline) for more details. [![Install in Obsidian](https://img.shields.io/badge/Install_in_Obsidian-7c3aed?style=for-the-badge&logo=obsidian&logoColor=white)](https://community.obsidian.md/plugins/prisma-calendar) [![Installation Guide](https://img.shields.io/badge/Installation_Guide-1f6feb?style=for-the-badge)](https://prisma-calendar.matejvavroproductivity.com/installation?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_installation_guide) --- ## Support & Sponsorship The best way to support Prisma Calendar is by purchasing a **[Pro License](https://prisma-calendar.matejvavroproductivity.com/features/free-vs-pro?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_advanced_features)**. You get powerful pro capabilities, priority support, and you directly fund continued development. You can also support through a donation: [![Donation Options](https://img.shields.io/badge/Donation_Options-8957e5?style=for-the-badge)](https://matejvavroproductivity.com/support/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_donation) ## Third-Party Independence Prisma Calendar is developed by [Matej Vavro](https://matejvavroproductivity.com/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_author) and is an independent, third-party product. **I am not affiliated with, endorsed by, or sponsored by Obsidian (Dynalist Inc.).** Prisma Calendar is a third-party community plugin. All references to "Obsidian" are for descriptive and compatibility purposes only. ## Privacy & Telemetry Prisma Calendar **does not include any client-side telemetry or analytics** โ€” no vault content, file names, or personal data is ever transmitted. The only server communication happens during Pro license verification, which sends basic device and version info for activation seat management. **If you only use the free features, no data is collected at all.** [Privacy Policy](https://matejvavroproductivity.com/privacy/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_privacy) ยท [Terms of Service](https://matejvavroproductivity.com/terms/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_terms) ยท [Legal Notice](https://matejvavroproductivity.com/legal/?utm_campaign=prisma_calendar&utm_source=github&utm_medium=repo&utm_content=readme_legal) ## License [AGPL-3.0](./LICENSE). --- ## Credits & Acknowledgments Prisma Calendar is built using [FullCalendar](https://fullcalendar.io/), a powerful and flexible JavaScript calendar library. FullCalendar provides the robust calendar rendering engine that powers Prisma Calendar's views and interactions. I'm grateful to the FullCalendar team for creating such an excellent foundation. --- > **This repository is a public, read-only mirror.** Development happens in a private monorepo โ€” this mirror exists for transparency and to follow the Obsidian convention of one repo per plugin. The code is licensed AGPL-3.0.