Linear Calendar

A linear calendar plugin that displays all 365 days of the year in a single view. Perfect for visualizing your notes chronologically, tracking events across time, and managing daily notes.

⚠️ Development Status

This plugin is in active development and may undergo significant changes. The core functionality—how notes are recognized and dates are extracted—will remain stable. If you use properties or dates in filenames, these will continue to work.

New features are actively being developed. If you encounter any issues or have feedback, please reach out via GitHub or via e-mail.

This plugin is being developed with the help of AI.

✨ Features

📝 Note Display

• Single-day notes: Notes appear in their respective day cells
• Multi-day events: Events spanning multiple days shown as horizontal bars
• Clickable notes: Click any note to open it instantly
• Instant tooltips: Hover over any note to see the full title immediately
• Note preview: Cmd/Ctrl + hover to see a preview of any note

📆 Daily Notes Integration

🧭 Periodic Notes

• Show various periods: Weekly, Monthly, Quarterly, Yearly, Custom Period
• Click on periodic notes to create or open them
• Compatible with the Periodic Notes Plugin – no transfer or copying needed
• Customizable appearance: edit colors, weekly note display mode
• Specify automated defaults: folder, date format, template

🔍 Flexible Date Extraction

Extract dates from multiple sources with customizable priority:

Start Date Sources:

• Properties (configurable, checked in order)
• Filename (first YYYY-MM-DD pattern)

End Date Sources (for multi-day events):

• Properties (configurable, checked in order)
• Filename (second YYYY-MM-DD pattern)

Examples:

---
date: 2024-01-15
date_end: 2024-01-20
---

Or use filenames:

• 2024-01-15 Meeting.md → Single-day note on Jan 15
• 2024-01-15 – 2024-01-20 Conference.md → Multi-day event Jan 15-20

🎨 Customization Options

Calendar Appearance:

• Width modes: Fit to screen (default) or scrollable with fixed cell widths
• Configurable cell width: Set minimum cell width (20-200px) for scrollable mode
• Column alignment: Weekday mode (align by day of week) or date mode (align by date number)
• Week start day: Configure first day of week (Sunday-Saturday)

Display Options:

• Show/hide daily notes in calendar cells
• Show/hide notes with date + text in title
• Optional date hiding: Display "Meeting Notes" instead of "2024-01-15 Meeting Notes"

📝 Quick Note Creation

• Create notes directly from the calendar
• Click on any calendar date to create a new note, drag to make multi day entry
• Configure note title, date method, metadata and save location
• Customize default data

🔎 Advanced Filtering

Filter which notes appear in the calendar:

Filter Modes:

• Show all notes: Display every note with a valid date (default)
• Include mode: Only show notes matching ALL conditions
• Exclude mode: Hide notes matching ALL conditions

Available Conditions:

• File properties (name, folder, path, extension)
• Custom frontmatter properties
• Text operators: is, contains, starts with, ends with, regex
• Special operators: exists, has tag, matches date pattern

Example Use Cases:

• Only show notes in "Projects" folder
• Exclude notes tagged with #draft
• Show only notes with a specific property

🎨 Color Categories

Organize and visualize your notes with custom colors and icons:

Visual Organization:

• Custom colors: Assign hex colors to categorize notes
• Optional icons: Add emoji or Lucide icons to categories
• Condition-based matching: Use the same powerful conditions as filters
• AND/OR logic: Match all conditions (AND) or any condition (OR)
• Priority system: Drag to reorder categories—first match wins

Category Index:

• Displays all categories as clickable chips at the top of the calendar
• Click any category to open the category editor
• Shows color and icon for quick visual reference

Display Options:

• Master toggle to enable/disable color categories
• Global setting to show/hide icons in calendar
• Set default color for uncategorized notes (custom or theme accent)

📥 Installation

From Obsidian Community Plugins (Recommended)

1. Open Obsidian Settings → Community plugins
2. Select Browse and search for "Linear Calendar"
3. Select Install, then Enable

Via BRAT (Alternative)

BRAT (Beta Reviewers Auto-update Tester) is an alternative installation method. It also gives access to pre-release versions. Note that all versions prior to 0.4.3 are pre-releases and only available via BRAT or manual installation.

1. Install the BRAT plugin from Obsidian's Community Plugins
2. Open BRAT settings (Settings → BRAT)
3. Click "Add Beta plugin"
4. Enter this repository: https://github.com/HomefulHobo/linear-calendar-plugin-obsidian
5. Click "Select a version"
6. Choose "Latest version"
7. Check "Enable after installing the plugin"
8. Click "Add Plugin"
9. Check if Linear Calendar is enabled in Settings → Community Plugins

Migrating from BRAT to Community Plugins? The migration is seamless — your plugin folder stays the same, just the updating method changes. Your settings are stored in your vault's plugin folder at .obsidian/plugins/linear-calendar/data.json and are not affected by the switch. Simply remove the plugin in BRAT settings (this will not remove the plugin), then install it through Community Plugins. To be sure, always back up your vault before migration.

🚀 Getting Started

1. Open the calendar: Click the calendar icon in the ribbon or use the command palette (Cmd/Ctrl+P → "Open Linear Calendar")

2. Configure date extraction: Go to Settings → Linear Calendar → Date Extraction

   • Add property names like date, lincal_date, or scheduled
   • Enable filename extraction if you use dates in filenames
   • Set priority if using both sources

3. Add notes to your calendar:

   • Use frontmatter properties:

     ---
     date: 2024-01-15
     ---
     

   • Or include dates in filenames: 2024-01-15 Meeting.md

4. Create multi-day events:

   • Add an end date property:

     ---
     date: 2024-01-15
     date_end: 2024-01-20
     ---
     

   • Or use two dates in filename: 2024-01-15 – 2024-01-20 Conference.md

5. Customize appearance: Adjust calendar width, cell size, and display options in settings

🤝 Contributing

Contributions are welcome! Please feel free to email me.

💚 Support

If you find this plugin helpful, consider:

• ⭐ Starring the repository
• 🐛 Reporting bugs or requesting features
• 📢 Sharing it with others