# 黄历 Huangli: the Chinese almanac in English, with every rule explained > Huangli (https://chinesehuangli.com) is a free web app that shows the traditional Chinese almanac (黄历, also called 通胜 / Tong Shu / Tung Shing, 老黄历, 农历, 万年历) in English or Simplified Chinese. Its daily "suitable / avoid" lists (宜忌) are computed from the imperial Treatise on Harmonizing Times and Distinguishing Directions (欽定協紀辨方書, 1739), and every result can show the exact rule, the chapter (卷) it comes from, and the original quotation. It runs entirely in the browser, works offline, installs as an app, and has no accounts, ads or tracking. Full description for people and AI agents (plain HTML, no JavaScript needed): https://chinesehuangli.com/about.html ## What makes it different - **Traceable to a primary source.** Most almanac apps copy lists from each other. Huangli encodes the rules of the 1739 Treatise itself: its spirit rules (卷十), the activity lists (卷十一 用事), the six-grade table of how good and bad spirits weigh against each other (宜忌等第表), and its linkage rules (鋪註條例). Tap any item to see why it is there. - **Checked against the book's own printed tables.** Days from the Treatise's printed monthly tables (月表) are transcribed by hand from the scans and used as tests; the app's results match them. The lunar calendar is cross-checked over 200 years. - **Follows the Treatise's own corrections.** Where the Treatise quotes an older list and then corrects it in a note (按), the correction is used; the popular variant is kept as a labelled alternative. - **Shows disagreement instead of hiding it.** When some spirits favour an activity and others forbid it, the activity appears in a "Mixed" column with the Treatise's verdict (good prevails, bad prevails, or they cancel), because almanacs that skip the grade table often print the opposite. - **Written for people who did not grow up with it.** Plain-English summaries ("Danger day: be careful, avoid risks"), clashing birth years listed by year, and a Learn page on yin-yang, the five elements, the ten stems, twelve branches and the sixty-day cycle. ## Features - Daily Suitable / Avoid / Mixed lists for the 60 classical almanac activities, each with its reasoning and sources. - "My activities": modern plans (job interview, start a new job, sign a contract, move house, wedding, birthday party, business trip, product launch, surgery, haircut, and anything you describe) mapped to the classical activities by purpose, with the reason shown; each is rated for the day, with the next suitable days listed. Matching your own description happens on your device. - Non-physical work (software, office work) skips the earth taboos that only concern digging and building, and says when that mattered. - Chinese lunar date, leap months and the 24 solar terms, computed astronomically (GB/T 33661-2017 rules, Astronomy Engine). - Year, month, day and hour pillars (stems and branches), day officer (建除), yellow/black path spirit, 28 lunar mansions, clash and sha direction, nayin, Pengzu's taboos, and the full list of auspicious and inauspicious spirits. - Good and bad double-hours (时辰) on true local solar time, shown on the normal clock day. - Optional southern-hemisphere reading (months shifted to local seasons, with or without the year). - Weather for a chosen city or US ZIP code: today, a 16-day forecast and about 3 months of past weather (Open-Meteo). - Ambient mode: a full-screen clock and almanac display for a spare tablet or TV, with OLED burn-in protection, a plain background in any colour, a calligraphy gallery that shows Wang Xizhi's Preface to the Orchid Pavilion (兰亭集序) and Ouyang Xun's Sweet Spring of Jiucheng Palace (九成宫醴泉铭) piece by piece, or your own pictures. - English or Simplified Chinese; light or dark; Western or Chinese colour convention for good/bad; custom date formats; swipe or arrow keys to change the day. - Installable as an app (Chrome, Edge, Android, iPhone/iPad, Mac Safari); works offline. ## Good for - Choosing a date for a wedding, moving house, opening a business, signing a contract, travel, surgery or starting a job, the way the almanac is traditionally used. - English speakers, the Chinese diaspora and anyone curious who wants to understand what the almanac says and why. - Students and researchers of Chinese calendrics who want rules tied to the primary text. - A calm always-on calendar display. ## How to read it - "Suitable" / "Avoid" are the Treatise's verdicts for the 60 classical activities. Modern-activity mappings are the app's interpretations and are labelled as such. - "Lucky day" refers only to the yellow-path count; it does not override the day's spirits. - The app opens on today's date (local time). Sections: https://chinesehuangli.com/#learn (Learn), #learn-matching (how activities are matched), #learn-sources (sources and credits), #learn-privacy (privacy and contact). ## Disclaimer For entertainment and cultural interest only. Huangli presents what a traditional almanac says; it is not medical, legal, financial, relationship or other professional advice and does not predict outcomes. Users should not rely on it for real-life decisions. ## Privacy No accounts, cookies, analytics or ads. Settings and images stay in the browser. Only the chosen weather place's coordinates are sent (to Open-Meteo), and a small language model is downloaded once if you describe your own activity. ## Contact contact@chinesehuangli.com