Update README.md

README.md

@@ -1 +1,47 @@
-WIP
+<h1 align="center">
+    <br>
+    <img src="https://i.imgur.com/U9vwPVo.png" alt="icon" width="100"/>
+    <p align="center">Three Coins</p>
+</h1>
+
+## About
+
+### three-coins
+
+A simple Linux desktop application for I Ching divination using the 3-coin method.
+
+### I Ching divination
+
+> I Ching divination is a form of cleromancy applied to the I Ching.
+> The text of the I Ching consists of sixty-four hexagrams:
+> six-line figures of yin (broken) or yang (solid) lines,
+> and commentaries on them.
+> There are two main methods of building up the lines of the hexagram,
+> using either 50 yarrow sticks or three coins.
+> Some of the lines may be designated "old" lines,
+> in which case the lines are subsequently changed
+> to create a second hexagram. The text relating to the hexagram(s)
+> and old lines (if any) is studied, and the meanings derived from
+> such study can be interpreted as an oracle.
+
+- From [Wikipedia](https://en.wikipedia.org/wiki/I_Ching_divination)
+
+### The 3-coin method
+
+> To use the coin oracle, you must have three similar coins.
+> Heads are yang and have value 3. Tails are yin and have value 2.
+> Throw the coins six times and add up the numbers each time.
+> For each throw record the number and kind of line it refers to
+> (6 = transforming yin; 7 = stable yang; 8 = stable yin; 9 = transforming yang).
+> Form your hexagram from the bottom up, then use the key to the hexagrams ...
+> to determine its number and name.
+
+- From [Wikibooks](https://en.wikibooks.org/wiki/I_Ching/The_3-coin_Method)
+
+## Gallery
+
+<p>
+  <img src="https://i.imgur.com/U8712Ju.png" width="300"/>
+  <img src="https://i.imgur.com/5qt6S2i.png" width="300"/>
+  <img src="https://i.imgur.com/BWaXni8.png" width="300"/>
+</p>