README file from
GithubFortune 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)
- Install the community plugin BRAT
- Run
BRAT: Add a beta plugin for testingfrom the command palette - Enter the repository:
QHX-HX/life-weather-forecast - Enable "Fortune Weather Calendar"
Option B: Manual
- Download
main.js,manifest.json,styles.cssfrom the latest GitHub Release - Put them in
<vault>/.obsidian/plugins/fortune-weather-calendar/ - Settings → Third-party plugins → Enable "Fortune Weather Calendar"
Quick start
- Open Settings → Fortune Weather Calendar and enter your birth date, time, gender, and birthplace
- Save — the home view and sidebar widget will show your daily fortune immediately
- 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
- Natal chart — Bazi chart (four pillars) with five-element balance and strength
- Favorable element — derives lucky color, direction and guidance
- Decade luck — locates the current Da Yun (e.g. 2024–2033)
- 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
npm install # install dependencies
npm run dev # watch build
npm run build # production build (main.js)
Run the official review locally before submitting:
npx obsidian-plugin-validator
Support
If you find this plugin useful, consider:
- ⭐ Starring the repository on GitHub
- Voluntary sponsorship via Buy Me a Coffee / 爱发电
License
MIT License · Copyright (c) 2026 qianhuixuan
Third-party dependency: lunar-javascript (MIT, 6tail) — full license retained in main.js.
中文简介
Fortune Weather Calendar(人生天气日历)是一款基于个人八字(四柱排盘)的每日人生天气日历 Obsidian 插件。通过"命局 → 大运 → 流年 → 流日"四层分析,为你生成每日宜忌、幸运色、吉时,以及事业、财运、健康、情感四维运势。支持出生地真太阳时修正与黄历术语现代化翻译。内容为传统文化娱乐参考,不构成任何决策建议。