Skip to content

About

Add linear calendars to your Obsidian notes using code blocks. Filter notes by tags, properties, or folders.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

ย 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Custom Linear Calendars for Obsidian

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.

โœจ Features

  • 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

๐Ÿš€ Usage

Basic Calendar

Insert a basic calendar into any note:

```custom-linear-calendar
```

Calendar with Filtering (Recommended Format)

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 tags property contains design
  • Extract start dates from the start_date property
  • Extract end dates from the end_date property (for multi-day events)

๐Ÿ“‹ Available Options

Year

Set which year to display:

year: 2024

Filter Property and Value

Filter notes by matching a property value:

property: tags
value: design

The property can be:

  • tags - Filter by Obsidian tags
  • file.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.

Start and End Date Properties

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)

Legacy Options (Still Supported)

Filter by Tag (Legacy)

Show only notes with a specific tag:

tag: projects

The tag can be specified with or without the # prefix.

Date Property (Legacy)

Specify which frontmatter property contains the date:

start-property: date
end-property: date_end

Calendar Width

Control calendar width:

width: fit-screen

or

width: scrollable
cell-width: 40

Filter by Property

Filter notes by any property:

filter: file.folder is Projects
filter: property:status is active

Filter Mode

Set filter mode (include/exclude):

filter-mode: include

From Filename

Extract dates from filenames:

from-filename: true

๐Ÿ“ Examples

Filter by Tags

Show only notes tagged "design":

```custom-linear-calendar
year: 2024
property: tags
value: design
start_date: start_date
end_date: end_date
```

Filter by Custom Property

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
```

Filter by File Folder

Show notes from a specific folder:

```custom-linear-calendar
year: 2024
property: file.folder
value: Projects
start_date: date
```

Scrollable Calendar with Wider Cells

```custom-linear-calendar
year: 2024
property: tags
value: meetings
start_date: date
width: scrollable
cell-width: 50
```

Multi-day Events

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.

๐Ÿ“ฅ Installation

  1. Copy this folder to your .obsidian/plugins/ directory
  2. Enable the plugin in Settings โ†’ Community Plugins
  3. Start using custom-linear-calendar code blocks in your notes!

๐Ÿ”ง Date Extraction

The plugin extracts dates from:

  • Frontmatter properties: Specify with property: or start-property: / end-property:
  • Filenames: Enable with from-filename: true to extract dates from filenames like 2024-01-15 Meeting.md

๐ŸŽจ Customization

Each calendar instance can be configured independently. Mix and match options to create different calendar views in different notes.

๐Ÿšง Planned Improvements

This plugin is a work in progress. Here are some UI and feature improvements planned:

UI Improvements

  • Better responsive design for different screen sizes
  • Improve styling throughout
  • Enhanced hover states and interactions
  • Refined color scheme and theming, with user-defined options

Feature Enhancements

  • 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!

๐Ÿ™ Credits & Attribution

This plugin is based on the Linear Calendar Plugin by HomefulHobo (Celine). The original plugin is licensed under the MIT License.

Key Differences from the Original

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.

About

Add linear calendars to your Obsidian notes using code blocks. Filter notes by tags, properties, or folders.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

โŒ‚