Skip to main content

Installation

Prisma Calendar is currently awaiting approval for the Obsidian Community Plugin store. While we wait for approval, you can install it using one of the methods below.

The easiest and most convenient way to install Prisma Calendar with automatic updates:

Steps​

  1. Install BRAT plugin (if you don't have it already)

    • Open Settings → Community Plugins → Browse
    • Search for "BRAT"
    • Install and enable BRAT
  2. Add Prisma Calendar via BRAT

    • Open Settings → BRAT
    • Click Add Beta Plugin
    • Enter the repository URL: https://github.com/Real1tyy/Prisma-Calendar
    • Click Add Plugin
  3. Enable the plugin

    • Go to Settings → Community Plugins
    • Find "Prisma Calendar" in the list
    • Toggle it on

Benefits of BRAT​

  • ✅ Automatic updates - Get new features and fixes automatically
  • ✅ Easy installation - Just paste the repo URL
  • ✅ One-click setup - No manual file management
  • ✅ Smoother experience - Updates handle themselves

📥 Manual Installation from GitHub Releases​

If you prefer manual installation or can't use BRAT:

Steps​

  1. Download the latest release

    • Go to GitHub Releases
    • Find the latest version (all releases are versioned and tagged)
    • Download these three files:
      • main.js
      • manifest.json
      • styles.css
  2. Create plugin folder

    • Navigate to your vault's plugins directory: {VaultFolder}/.obsidian/plugins/
    • Create a new folder: prisma-calendar
    • Full path should be: {VaultFolder}/.obsidian/plugins/prisma-calendar/
  3. Move files

    • Place the three downloaded files into the prisma-calendar folder
  4. Reload Obsidian

    • Press Ctrl/Cmd + R to reload Obsidian
    • Or close and reopen Obsidian
  5. Enable the plugin

    • Go to Settings → Community Plugins
    • Find "Prisma Calendar" in the installed plugins list
    • Toggle it on

Note on Manual Updates​

With manual installation, you'll need to repeat these steps whenever you want to update to a new version. Consider using BRAT for automatic updates.

✨ Coming Soon: Community Plugin Store​

Once Prisma Calendar is approved for the Obsidian Community Plugin store, you'll be able to install it directly:

  1. Open Settings → Community Plugins → Browse
  2. Search for "Prisma Calendar"
  3. Click Install
  4. Enable the plugin

We'll update this page as soon as the plugin is available in the store!

Requirements​

  • Obsidian 1.5+
  • For templating features, install the Templater plugin

First-time setup checklist​

  • Create or pick a folder for your calendar notes (e.g., Calendar/)
  • (Optional) Create a Templater template for new events
  • Open Settings → Prisma Calendar and choose your Active Calendar
  • Set Directory to your chosen folder
  • Review frontmatter property names (Start/End/AllDay/Title) and adjust if you already use different keys

Optional: Minimal Templater template​

---
Title: <% tp.file.title %>
Start: <% tp.date.now("YYYY-MM-DDTHH:mm") %>
End: <% tp.date.now("YYYY-MM-DDTHH:mm", 60*60*1000) %>
AllDay: false
Status: Inbox
---

# <% tp.file.title %>

Notes here...