diff --git a/README.md b/README.md
index 067c0ba60..403da032b 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 000000000..f570e4299
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 000000000..e20ca9d95
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 000000000..a59b988f2
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 000000000..8e0b3ccac
Binary files /dev/null and b/readme/compare_encoded_namedlink.png differ