Birthday Reminder

English | 中文文档

An Obsidian plugin designed to help you easily manage important birthday information for friends, family, colleagues, and clients. The plugin supports Gregorian/Lunar calendar conversion, zodiac and Chinese animal sign display, intelligent calendar view, and automatically adapts to sidebar and main window layouts.

Whether you use Obsidian for personal life management or as a CRM tool for client relationships, this plugin makes birthday reminders elegant and efficient.

(Preview below)

This plugin is fully AI-generated, so please bear with me if there are any issues.

2 ✨ Features

2.1 🎯 Core Features

2.2 📊 Statistics

• Statistics Cards: Total count, today's birthdays, birthdays within 7 days, birthdays within 30 days at a glance
• Auto-grouping: Automatically categorized into today, next 7 days, next 30 days, and later birthdays
• Sorted Display: Automatically sorted by remaining days, upcoming birthdays appear first

2.3 📅 Calendar View

• Monthly Calendar: Displays all birthdays in calendar format, birthday dates highlighted
• Month Navigation: Supports previous/next month switching, one-click return to today
• Birthday Preview: Shows names of people with birthdays directly on calendar cells
• Click to Open: Click any birthday card or calendar cell to jump directly to the corresponding note

2.4 🎨 Interface Adaptation

• Responsive Layout: Automatically detects window width – compact mode in sidebar, full mode in main window
• Multiple Color Schemes: 5 built-in color schemes (Default, Warm Orange, Cool Blue, Nature Green, Elegant Purple)
• Dark/Light Theme: Perfectly adapts to Obsidian's dark and light themes

2.5 🌐 Multi-language Support

• Chinese/English: Interface language switching to meet different user needs
• Full Localization: All interface text fully translated for consistent experience

2.6 ⚙️ Highly Configurable

3 🌟 Highlights

3.1 Configurable Birthday Property

No longer limited to the birthday property name! You can use any property name you prefer:

Option 1: Use default property

birthday: 1990-05-20

Option 2: Customize to date_of_birth

date_of_birth: 1990-05-20

Option 3: Customize to DOB

DOB: 1990-05-20

Simply configure the corresponding property name in plugin settings, and it will be automatically recognized!

3.2 One Field, All Features

Just add the birthday property to your note's frontmatter, and all features work automatically.

3.3 Perfect Sidebar & Main Window Adaptation

• Drag to sidebar → Automatically switches to compact mode, saving space
• Drag to main window → Automatically switches to full mode, displaying more information

3.4 Precise Lunar Conversion

Uses the professional solarlunar library, supporting precise lunar conversion for years 1900-2100, correctly handling leap months.

3.5 Elegant Calendar View

• Automatically fills previous/next month dates at month boundaries
• Cross-month dates displayed semi-transparently
• Today's date highlighted with special border
• Birthday cells support hover tooltips

3.6 One-Click Note Navigation

Click any birthday card or birthday name in the calendar to immediately open the corresponding note – no manual searching required.

3.7 Performance Optimized

• Uses ResizeObserver to monitor window changes for real-time layout adjustment
• Birthday data indexed by month, O(1) complexity for calendar rendering
• Automatically refreshes data every hour

4 📸 Interface Preview

4.1 Main Window Mode (Full Layout)

4.2 Sidebar Mode (Compact Layout)

4.3 Plugin Settings

5 🚀 Quick Start

5.1 Installation

The plugin is now available in the Obsidian Community Plugin Store! 🎉

Method 1: Install from Community Plugins (Recommended)

1. Open Settings → Community Plugins
2. Click Browse and search for Birthday Reminder
3. Click Install and then Enable

Method 2: Install via BRAT

1. Open Settings → BRAT (under Community Plugins)
2. Click the Add Beta Plugin button
3. Enter the repository address: https://github.com/ichris007/Obsidian-Birthday-Reminder
4. Click Add Plugin – BRAT will automatically download and install it
5. Go to Settings → Community Plugins, find Birthday Reminder, and enable it

Method 3: Manual Installation

1. Download the latest release (main.js, manifest.json, styles.css) from the Releases page
2. Extract the files into: .obsidian/plugins/birthday-reminder/
3. Restart Obsidian and enable the plugin

5.2 Configuration Steps

1. After enabling the plugin, click the "Settings" icon next to it
2. Set Birthday Property Name (optional): If you use a custom property name like date_of_birth, enter it here
3. Set Target Folder: Specify the folder containing person notes (e.g., 07Relations/)
4. Adjust other options as needed (color scheme, display settings, etc.)
5. Add birthday property to notes in the target folder:

For example:

birthday: 1990-05-20

5.3 Usage

• Click the cake icon 🎂 in the left sidebar to open the birthday reminder panel
• Or use the Command Palette (Ctrl/Cmd + P) and type "Birthday Reminder"

6 📝 Changelog

v1.5.2 (2026-07-16)

• 🐛 Fixed age calculation logic – Correctly handles birthdays that have already passed this year, preventing off-by-one-year age errors
• 🔧 Improved code clarity with explicit birthMonth/birthDay variable extraction

v1.5.1 (2026-07-16)

• 🔧 Installation fix – Lowered minAppVersion to 1.12.7 to resolve "no appropriate version found" error
• 🌐 Complete localization – All settings UI text fully localized; color scheme names now display in the selected language
• ✨ Slider dynamic tooltip – Shows current value (e.g., "3 months") when dragging the visible months slider
• 🎨 Color preview real-time update – Preview updates immediately when switching color schemes
• 🔄 Language switching instant – Settings panel refreshes immediately when switching languages

7 🙏 Acknowledgments

• solarlunar- Lunar calendar calculation library
• Obsidian - Excellent note-taking software

8 📄 License

MIT License

9 🔗 Links

• GitHub Repository
• Issue Tracker
• Lifein OS - A personal productivity and life management system built with Obsidian.

10 💡 FAQ

10.1 Q: I use the date_of_birth property. Can it be supported?

A: Yes! Simply change the "Birthday Property Name" in plugin settings to date_of_birth.

10.2 Q: Can multiple different property names be supported simultaneously?

A: Currently only one property name is supported, but you can choose the one you use most frequently and unify other notes accordingly.

10.3 Q: Is the lunar date accurate?

A: The plugin uses the professional solarlunar library, supporting precise lunar conversion for years 1900-2100, including leap month handling.

10.4 Q: Does the layout automatically switch between sidebar and main window?

A: Yes! The plugin automatically detects window width – switches to compact mode when width is less than 450px, and full mode when width is 450px or greater.