# Fortune Weather Calendar
**Your personal daily "weather" of life fortune**, generated from your Bazi (Eight Characters / Four Pillars) through a four-layer analysis: Natal Chart → Decade Luck (Da Yun) → Year Luck (Liu Nian) → Day Luck (Liu Ri).
✨ Daily Yi/Ji (do / avoid) · Lucky color · Auspicious hours · Career / Wealth / Health / Love trends
> Content is traditional-culture entertainment only. It is not absolute and is not a substitute for professional advice.
---
**Fortune Weather Calendar** is a personal daily-fortune calendar based on your Bazi (Eight Characters / Four Pillars). It derives each day's weather-style fortune through a four-layer analysis: Natal Chart → Decade Luck (Da Yun) → Year Luck (Liu Nian) → Day Luck (Liu Ri), showing your daily suitable/taboo activities (Yi/Ji), lucky color, auspicious hours, and four-dimensional trends (career, wealth, health, love). Personalization is driven by your birth info and true solar time.
## Features
- **Home view** — opens automatically in the main area when Obsidian starts, showing today's fortune at a glance
- **Sidebar widget** — a compact daily-fortune card pinned to the right sidebar
- **Auto refresh across days** — regenerates at open time and re-checks every 5 minutes, so it rolls over at midnight automatically
- **Note cards** — one-click insert of today's or this week's fortune cards into any note (great for journaling)
- **Four-layer engine** — natal chart → decade luck → year luck → day luck, not just the day
- **Personalized content** — favorable element (Xi Shen) decides your lucky color and guidance; Yi/Ji, auspicious hours and direction change daily
- **True solar time** — birth place longitude corrects your birth time for precise hour pillars
- **Modern wording** — classical almanac terms are translated into plain, youth-friendly language
## Screenshots
## Installation
> Requires Obsidian **1.5.0** or later.
**Option A: BRAT (beta testing)**
1. Install the community plugin [BRAT](https://obsidian.md/plugins?id=obsidian42-brat)
2. Run `BRAT: Add a beta plugin for testing` from the command palette
3. Enter the repository: `QHX-HX/life-weather-forecast`
4. Enable "Fortune Weather Calendar"
**Option B: Manual**
1. Download `main.js`, `manifest.json`, `styles.css` from the latest GitHub Release
2. Put them in `/.obsidian/plugins/fortune-weather-calendar/`
3. Settings → Third-party plugins → Enable "Fortune Weather Calendar"
## Quick start
1. Open **Settings → Fortune Weather Calendar** and enter your birth date, time, gender, and birthplace
2. Save — the home view and sidebar widget will show your daily fortune immediately
3. It refreshes automatically every day
> ⚠️ The default birth info is sample data (1990-08-20 09:30). Be sure to change it to yours.
## Usage
| Command | Description |
|---------|-------------|
| Open fortune home | Open the home card in the main area |
| Toggle sidebar fortune | Toggle the right-sidebar daily card |
| Insert today's fortune into note | Insert today's card at the cursor |
| Insert this week's fortune | Insert 7 day cards |
Ribbon icons: ⚡ open home · ↗ toggle sidebar
## How it works
1. **Natal chart** — Bazi chart (four pillars) with five-element balance and strength
2. **Favorable element** — derives lucky color, direction and guidance
3. **Decade luck** — locates the current Da Yun (e.g. 2024–2033)
4. **Year luck + Day luck** — overlays the year (e.g. 2027 Ding Wei) and day ganzhi for daily Yi/Ji, auspicious hours and four-dimensional trends
## Compatibility
- **Platform**: Desktop and mobile (`isDesktopOnly: false`)
- **Language**: Simplified Chinese UI (English description provided)
- **Dependency**: open-source `lunar-javascript` (MIT)
## Privacy & compliance
- Birth info is stored **locally only** (`data.json`); nothing is uploaded
- Content is traditional-culture entertainment; no medical, investment, or legal advice
- No forced payment, no telemetry, no ads
## Development
```bash
npm install # install dependencies
npm run dev # watch build
npm run build # production build (main.js)
```
Run the official review locally before submitting:
```bash
npx obsidian-plugin-validator
```
## Support
If you find this plugin useful, consider:
- ⭐ Starring the repository on GitHub
- Voluntary sponsorship via [Buy Me a Coffee](https://www.buymeacoffee.com) / [爱发电](https://afdian.com)
## License
[MIT License](./LICENSE) · Copyright (c) 2026 **qianhuixuan**
Third-party dependency: `lunar-javascript` (MIT, [6tail](https://6tail.cn)) — full license retained in `main.js`.
---
## 中文简介
Fortune Weather Calendar（人生天气日历）是一款基于个人八字（四柱排盘）的每日人生天气日历 Obsidian 插件。通过"命局 → 大运 → 流年 → 流日"四层分析，为你生成每日宜忌、幸运色、吉时，以及事业、财运、健康、情感四维运势。支持出生地真太阳时修正与黄历术语现代化翻译。内容为传统文化娱乐参考，不构成任何决策建议。