About this site

This is a small collection of Chinese divination tools, written for people outside China who have heard of these methods and cannot find a usable version in English. Most of what exists online is either a paid app, a badly translated chart with no explanation, or a wall of classical terminology that assumes years of study.

The goal here is the opposite: the shortest correct implementation of each method, followed by a reading you can actually understand. Where the tradition genuinely disagrees with itself, the text says so rather than inventing a confident answer.

Everything runs in your browser

All four tools compute locally. There is no account, no database of readings, no analytics on what you ask, and no server call when you cast. The site is a set of static pages plus a few kilobytes of JavaScript; once loaded it keeps working without a network connection.

This is a deliberate choice, not a technical accident. A reading is a private thing to ask about, and there is no reason for it to travel anywhere.

How the readings are written

The explanatory text is written by hand, not generated per user. Each palace has a fixed reading: what it concerns, its timing, the action it suggests, what it favours and what it warns against. The three-transmission synthesis — the paragraph that ties origin, course and outcome together — is generated from those fixed readings by rules, not by a language model, so the same cast always gives the same answer.

Accuracy

The core counting logic is covered by exhaustive tests across every possible lunar month, day and double-hour combination, and the calendar conversions use a well-established Chinese calendar implementation for leap months, solar terms and the sixty-day cycle. If you believe a reading is wrong, the method itself is short enough to check by hand — and that is the right way to settle it.

Contact

Corrections, especially from practitioners who follow a different lineage, are genuinely welcome.