黄历 Huangli: the Chinese almanac in English, with every rule explained

Huangli is a free web app for the traditional Chinese almanac (黄历, also called 通胜, Tong Shu or Tung Shing). It tells you which activities are suitable or to be avoided on any day, and, unlike other almanacs, it shows why: the exact rule, the chapter of the source text, and the original quotation.

Open the almanac

What makes it different

Features

Good for

How to read it

"Suitable" and "Avoid" are the Treatise's verdicts for its 60 classical activities. The mappings from modern activities are the app's own interpretations and are labelled as such. "Lucky day" refers only to the yellow-path count and does not override the day's spirits. The almanac is a cultural tradition, not a guarantee of outcomes.

Disclaimer

For entertainment and cultural interest only. Huangli shows what a traditional Chinese almanac says. It is not medical, health, legal, financial, relationship or any other professional advice, and it does not predict or guarantee any outcome. Do not rely on it for real-life decisions; consult a qualified professional. You use it at your own risk.

Privacy

No accounts, cookies, analytics or ads. Everything is calculated on your device and settings stay in your browser. Only a chosen weather place's coordinates are sent (to Open-Meteo).

Sources

欽定協紀辨方書 (1739, Siku Quanshu edition; Wikisource, Kanseki Repository and CADAL scans), GB/T 33661-2017, Astronomy Engine, Open-Meteo, public-domain calligraphy scans, and the National Palace Museum, Taipei (open data). Full credits are in the app under Sources and credits.

Contact: contact@chinesehuangli.com · chinesehuangli.com · llms.txt