diff --git a/README.md b/README.md
index 4ee59ed..f51284e 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,56 @@
 # FakeKitten
 
-a simple script to upload whatever on Amazon Prime Photos
-
-¯\_(ツ)_/¯
\ No newline at end of file
+a simple script to upload whatever on Amazon Prime Photos
+
+¯\\_(ツ)_/¯
+
+## why:
+Amazon Prime Photos allows you to upload everything as long as it's an [image](https://www.amazon.com/gp/help/customer/display.html?nodeId=GGU2SU8Y22DZYRMQ),
+giving you unlimited storage (I expect them to do facial recognitioning or other unholy things with your images).
+
+so we can leverage this dynamic to upload any file to resemble an image,
+just by appending the original file at the end of a random image we are generating on the fly.
+
+the images will be saved as a raw image file, .DNG extension, so the site won't touch it trying to re-compress the image to save files
+
+I've tried to upload files and managed to get 3.5GB without issues
+
+## usage:
+
+### encoding:
+
+`./FakeKitten.sh yourfile.pdf encode`
+
+you will obtain a file named: 
+
+```
+FakeKitten_143442_yourfile.pdf_3a1863591abdce897987971928512865db_random.DNG
+```
+
+where the file name is composed like this:
+
+```
+[constant]\_[image blocksize]\_[originale filename]\_[sha1sum of the original file]\_[decoy image filename]
+```
+
+at this point you can manually upload it on Amazon Prime Photos
+
+
+### decoding:
+
+```
+./FakeKitten.sh FakeKitten_143442_yourfile.pdf_3a1863591abdce897987971928512865db_random.DNG decode
+```
+
+you will obtain your original file:
+
+```
+yourfile.pdf
+```
+
+## todo:
+
+- [ ] file encryption
+
+
+[0]: https://www.amazon.com/gp/help/customer/display.html?nodeId=GGU2SU8Y22DZYRMQ
\ No newline at end of file