diff --git a/README.md b/README.md
index 9df747a..3414cc3 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,49 @@
 # fallen_london_scripts
 
-A user script for the game Fallen London https://www.fallenlondon.com/
\ No newline at end of file
+A user script for the game Fallen London https://www.fallenlondon.com/
+
+## Warning
+
+The "Our appologies" error message might appear a little more frequently than usual when using this script.:w!
+
+## Description
+
+The purpose of this script is to make the usage of FL easier. This is achived via 3 methods.
+
+### Display stats CPs
+
+![CP are displayed under the stats](img/stats+CP.png)
+
+Change points are displayed under each stat bar.
+
+The format is A (B+C/D), with:
+- A: The total number of change points earned from level 0
+- B: The number of change points until the last level
+- C: The number of change points from the last level
+- D: The number of change points needed to reacht the next level.
+
+For instance, 191 change points of Making Waves have been accumulated, 190 to reach level 19 and 1 more out of the 20 needed to reach level 20.
+
+
+### Always display some qualities or possessions
+
+![CP are displayed under the stats](img/qualities.png)
+
+Under the "TRAVEL" button, 3 blocks are displayed:
+- Renown & Favours: A list of factions icons is displayed with a Renown+Favour "bubble" on the bottom. The color changes when Favours increase: yellow at 5, orange at 6 and finally red at 7.
+- Quirks: Same thing with the quirks, except everything is green. And white.
+- Advantages: Again same thing for the advantages (also called second chances).
+
+Please note that this is NOT dynamic. It will only be displayed and updated after visiting /myself and /possessions.
+
+### Optimize space
+
+The banner and candles are removed to prevent scrolling too much
+
+## TODO
+
+Things that can be done, maybe later, one day, probably...:
+- The numbers associated with the advanages could change color too when reaching 21.
+- Allow the userscrip to be customized. It could be done if there are more than one person using it.
+- Some infobbles would be nice.
+- Dynamically update the qualities/possessions displayed
diff --git a/img/qualities.png b/img/qualities.png
new file mode 100644
index 0000000..f450dab
Binary files /dev/null and b/img/qualities.png differ
diff --git a/img/stats+CP.png b/img/stats+CP.png
new file mode 100644
index 0000000..c72fe9b
Binary files /dev/null and b/img/stats+CP.png differ