Mood Calendar

中文 | English

Mood Calendar displays your daily notes in a calendar view, with a mood emoji shown beneath each date. It reads the mood field from your note's frontmatter and pairs it with a one-click workflow: tap a date, pick a mood, and the note is created for you. Journaling and mood tracking become one seamless gesture. If this plugin helps you, a ⭐ would mean a lot!

Preview

---

✨ Features

• Sidebar calendar: Opens automatically in the right sidebar on startup; can also be summoned anytime via the smiley icon in the left ribbon. Supports embedding in any note with a ```mood-calendar code block.
• Mood visualization: Displays the mood emoji read from each note's frontmatter beneath the date. Display length is configurable (single emoji or full text).
• One-click mood logging: Click a date with no note → a mood picker pops up → the note is created with the chosen mood written to frontmatter. No manual property editing needed.
• Hover to edit: Hover over the MyMood property value in the editor and a mood picker appears — one click to update that day's mood.
• Note status at a glance:
  • 😶 No marker — no note exists for this date
  • ⚫ Filled dot — note exists but has no mood and no pending tasks
  • ⚪ Hollow dot — note exists with unfinished tasks - [ ]
• Smart follow: The calendar automatically jumps to the month of the active file and highlights today; manual month navigation won't be interrupted.
• Deep daily-notes integration: Automatically reads the date format, folder, and template from the built-in Daily Notes or Periodic Notes plugin. Supports directory-based formats like YYYY/MM/YYYY-MM-DD.
• Bilingual UI: Interface language can be switched in settings (English / 中文).

📦 Installation

Option 1: Obsidian Community Plugin (Recommended)

Search for "Mood Calendar" in Settings → Community plugins inside Obsidian.

Option 2: Manual Installation

1. Download the latest main.js, manifest.json, and styles.css from Releases.
2. Create the directory .obsidian/plugins/mood-calendar/ in your vault.
3. Place the three files into that directory.
4. Restart Obsidian and enable Mood Calendar under Settings → Community plugins.

🚀 Usage

Calendar View

The calendar opens automatically in the right sidebar when the plugin loads. Click a date:

• Note exists → opens it directly.
• No note → a mood picker pops up; choose a mood and the note is created with the mood written to frontmatter. Click "Skip" to create a note without a mood.

You can disable the mood popup on creation in settings, falling back to a traditional confirm dialog or immediate creation.

Code Block Embed

Insert the following in any note:

```mood-calendar
```

This renders the current month's calendar inline.

Hover to Edit Mood

In the editor (Live Preview mode, or Reading mode if the corresponding setting is enabled), hover over the MyMood property value in a daily note. A mood picker appears — click an option to update.

⚙️ Settings

🔧 Compatibility

• Templater: The mood field is written to frontmatter as plain text without parsing YAML, so templates containing <% ... %> Templater syntax won't cause errors.
• Daily Notes / Periodic Notes: Automatically detects date format, folder, and template configuration from either plugin.
• Mobile: isDesktopOnly: false — core features work on mobile.

🗂️ Project Structure

mood-calendar/
├── main.js        # Plugin logic (plain JS, no build step required)
├── manifest.json  # Plugin manifest
├── styles.css     # Styles
└── README.md

This plugin is written in plain JavaScript with no build step. Edit main.js, reload, and changes take effect immediately. Feel free to read the source or submit a PR.

📄 License

MIT © Xzhi

💖 Support

If you enjoy this plugin and want to say thanks, you can buy me a bubble tea!