Obsidian Stats logoObsidian Stats

Year Glance

by yy
5
4
3
2
1
Score: 35/100
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Render yearly calendar views with events marked and color-coded.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
1
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Year Glance

A yearly calendar plugin for Obsidian that renders a whole-year view with events marked using colored indicators.

12-rows expanded layout

3x4 compact layout

Installation

Community Plugin (Recommended, but currently under review and not yet available)

  1. Open Obsidian Settings → Community plugins
  2. Click "Browse" and search for "Year Glance"
  3. Click "Install" then "Enable"

Manual Installation

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create a folder called year-glance in your vault's .obsidian/plugins/ directory
  3. Copy the downloaded files into this folder
  4. Restart Obsidian and enable "Year Glance" in Settings → Community plugins

Basic Usage

Create a code block with year_glance as the language:

```year_glance
---
year: 2026
---

@Trips
- 20260601-20260608: A trip to Boston
- 20260815-20260820: Summer vacation

@Deadlines
- 20260731: Project X deadline
- 20261215: Annual review
```

Configuration Options

All options are specified in the YAML frontmatter between --- markers.

Option Values Default Description
year Any year (e.g., 2026) Current year The year to display
layout 3x4, 12-rows 3x4 Calendar layout style
weekStart sunday, monday sunday First day of the week
style compact, expanded compact Display style
showToday true, false true Show today indicator (diamond + accent color)

Layouts

  • 3x4 - Traditional 3×4 grid with months arranged in rows
  • 12-rows - One month per row, all days shown horizontally

Display Styles

  • compact - Minimal look with small colored indicator bars. Hover over a day to see event details in a tooltip.
  • expanded - Event text is visible directly on the calendar. Multi-day events show as colored bars spanning multiple days; single-day events show as bullets with text.

Event Syntax

Categories

Categories group related events and share a color. Define them with @CategoryName:

@Trips
- 20260601-20260608: Boston conference

@Deadlines
- 20260731: Project deadline

Custom Colors

Optionally specify a hex color for a category:

@Trips [#ff6b6b]
- 20260601-20260608: Boston conference

@Holidays [#4ecdc4]
- 20261225: Christmas

If no color is specified, colors are auto-assigned from a built-in palette.

Date Formats

  • Single day: YYYYMMDD (e.g., 20260715)
  • Date range: YYYYMMDD-YYYYMMDD (e.g., 20260601-20260608)

Full Example

```year_glance
---
year: 2026
layout: 3x4
weekStart: monday
style: expanded
---

@Trips [#e63946]
- 20260601-20260608: Boston conference
- 20260815-20260820: Summer vacation in Hawaii

@Deadlines [#457b9d]
- 20260131: Q1 planning complete
- 20260430: Tax filing deadline
- 20260731: Project X milestone

@Holidays [#2a9d8f]
- 20260101: New Year's Day
- 20260704: Independence Day
- 20261225: Christmas
```

Color Palette

When colors are not specified, the following palette is used (in order):

  1. #e63946 - Red
  2. #457b9d - Steel Blue
  3. #2a9d8f - Teal
  4. #e9c46a - Yellow
  5. #f4a261 - Orange
  6. #9c89b8 - Purple
  7. #a8dadc - Light Cyan
  8. #264653 - Dark Teal
Sponsors