A linear calendar plugin that displays all 365 days of the year in a single view. Insert calendars directly into any note using code blocks with customizable settings.
โ ๏ธ Work in Progress: This plugin is actively being developed and improved. Features and UI may change. Feedback and suggestions are welcome!
Note: This plugin is based on the Linear Calendar Plugin by HomefulHobo, but has been significantly modified to support inline code block rendering and different filtering options.
- Inline Calendar Rendering: Insert calendars into any note using code blocks
- Per-Calendar Settings: Configure each calendar instance independently
- Tag and Property Filtering: Filter notes by tags or other properties
- Multi-day Events: Display events spanning multiple days as horizontal bars
- Flexible Date Extraction: Extract dates from frontmatter properties or filenames
Insert a basic calendar into any note:
```custom-linear-calendar
```Filter notes by a property and value, and specify date properties:
```custom-linear-calendar
year: 2024
property: tags
value: design
start_date: start_date
end_date: end_date
```This example will:
- Show the year 2024
- Filter notes where the
tagsproperty containsdesign - Extract start dates from the
start_dateproperty - Extract end dates from the
end_dateproperty (for multi-day events)
Set which year to display:
year: 2024
Filter notes by matching a property value:
property: tags
value: design
The property can be:
tags- Filter by Obsidian tagsfile.name,file.basename,file.folder,file.path,file.ext- Filter by file properties- Any frontmatter property name (e.g.,
status,category,project)
The value is what to match in that property.
Specify which properties contain the dates:
start_date: start_date
end_date: end_date
start_date- The property containing the start date (required)end_date- The property containing the end date (optional, for multi-day events)
Show only notes with a specific tag:
tag: projects
The tag can be specified with or without the # prefix.
Specify which frontmatter property contains the date:
start-property: date
end-property: date_end
Control calendar width:
width: fit-screen
or
width: scrollable
cell-width: 40
Filter notes by any property:
filter: file.folder is Projects
filter: property:status is active
Set filter mode (include/exclude):
filter-mode: include
Extract dates from filenames:
from-filename: true
Show only notes tagged "design":
```custom-linear-calendar
year: 2024
property: tags
value: design
start_date: start_date
end_date: end_date
```Show notes where a custom property matches a value:
```custom-linear-calendar
year: 2024
property: project
value: website-redesign
start_date: date
end_date: date_end
```Show notes from a specific folder:
```custom-linear-calendar
year: 2024
property: file.folder
value: Projects
start_date: date
``````custom-linear-calendar
year: 2024
property: tags
value: meetings
start_date: date
width: scrollable
cell-width: 50
```To create multi-day events, specify both start and end date properties:
```custom-linear-calendar
year: 2024
property: tags
value: conference
start_date: start_date
end_date: end_date
```Then in your notes:
---
tags: conference
start_date: 2024-01-15
end_date: 2024-01-20
---This will display as a multi-day event spanning from January 15 to January 20.
- Copy this folder to your
.obsidian/plugins/directory - Enable the plugin in Settings โ Community Plugins
- Start using
custom-linear-calendarcode blocks in your notes!
The plugin extracts dates from:
- Frontmatter properties: Specify with
property:orstart-property:/end-property: - Filenames: Enable with
from-filename: trueto extract dates from filenames like2024-01-15 Meeting.md
Each calendar instance can be configured independently. Mix and match options to create different calendar views in different notes.
This plugin is a work in progress. Here are some UI and feature improvements planned:
- Better responsive design for different screen sizes
- Improve styling throughout
- Enhanced hover states and interactions
- Refined color scheme and theming, with user-defined options
- Additional filtering options
- Calendar export functionality
- Performance optimizations for large note collections
- Additional date format support
Have suggestions? Feel free to open an issue or contribute!
This plugin is based on the Linear Calendar Plugin by HomefulHobo (Celine). The original plugin is licensed under the MIT License.
This version has been significantly modified to:
- Inline Code Block Rendering: Calendars are inserted directly into notes using code blocks instead of opening in a separate view
- Removed Daily Notes Functionality: Daily notes features have been removed
- Simplified Filtering: Streamlined filtering options focused on property and tag-based filtering
- Per-Calendar Configuration: Each calendar instance can have its own settings defined in the code block
The core calendar rendering logic, date extraction, and multi-day event handling are based on the original implementation.