diff --git a/README.md b/README.md
index 067c0ba60f..403da032bb 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,9 @@
-# cf_email_decoder
+# cf\_email\_decoder
+cf\_email\_decoder is a userscript that decodes email addresses that are protected by Cloudflare
 
+## Comparisons
+
+| Encoded                                 | Decoded                                 |
+|-----------------------------------------|-----------------------------------------|
+|![](readme/compare_encoded_namedlink.png)|![](readme/compare_decoded_namedlink.png)|
+|![](readme/compare_encoded_address.png)  |![](readme/compare_decoded_address.png)  |
diff --git a/readme/compare_decoded_address.png b/readme/compare_decoded_address.png
new file mode 100644
index 0000000000..f570e42998
Binary files /dev/null and b/readme/compare_decoded_address.png differ
diff --git a/readme/compare_decoded_namedlink.png b/readme/compare_decoded_namedlink.png
new file mode 100644
index 0000000000..e20ca9d954
Binary files /dev/null and b/readme/compare_decoded_namedlink.png differ
diff --git a/readme/compare_encoded_address.png b/readme/compare_encoded_address.png
new file mode 100644
index 0000000000..a59b988f23
Binary files /dev/null and b/readme/compare_encoded_address.png differ
diff --git a/readme/compare_encoded_namedlink.png b/readme/compare_encoded_namedlink.png
new file mode 100644
index 0000000000..8e0b3ccacf
Binary files /dev/null and b/readme/compare_encoded_namedlink.png differ