diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2bc5d07
--- /dev/null
+++ b/README.md
@@ -0,0 +1,193 @@
+# aarty: A simple CLI tool to convert the images to ASCII art with rust 🦀
+
+![srceenshots/anime_2_colored_scale_4.gif](./srceenshots/anime_2_colored_scale_4.gif)
+![money mouth face colored scale 2](./srceenshots/money_mouth_face_colored_scale_2.png)
+![money mouth face normal scale 2](./srceenshots/money_mouth_face_normal_scale_2.png)
+
+
+More screenshots
+
+![crab colored scale 1](./srceenshots/crap_colored_scale_1.png)
+[Original image](./images/crab.png)
+![crap colored scale](./srceenshots/crap_colored_scale_2.png)
+[Original image](./images/crab.png)
+![nerd face colored scale](./srceenshots/nerd_face_colored_scale_2.png)
+[Original image](./images/nerd_face.png)
+![nerd face normal scale](./srceenshots/nerd_face_normal_scale_2.png)
+[Original image](./images/nerd_face.png)
+![srceenshots/anime_2_colored_scale_4.gif](./srceenshots/anime_2_colored_scale_4.gif)
+[Original image](./images/anime_2.jpg)
+![anime colored scale 3](./srceenshots/anime_colored_scale_3.gif)
+[Original image](./images/anime.jpg)
+
+
+
+```
+ ~~~~~~~!!!!~!!~ ~!!!!!!!!!~~~~~
+ ~~~~!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!~~~~
+ ~~~~~!!!!!!!!!!!!!!!!!!~ !!!!!!!!!!!!!!!!!!!!~~~~
+ ~~~~~~!!!!!!!!!!!!!!!!!!!~ ~!!!!!!!!!!!!!!!!!!!!!!~~~~
+ ~~~~~~~!!!!!!!!!!!!!!!!!!!!! !!!!!!!!!!!!!!!!!!!!!!!!~~~~~
+ ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!~!!!!!!!!!!!!!!!!!!!!!!!!~~~~~
+ ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~
+ ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~
+ ~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~
+ ~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~
+ ~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~
+ ~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~
+ ~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~
+ ~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~
+ ~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~~
+ ~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!!!!!!!!~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~!!!!!!!!!!!!!!!!!!!~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~!!!~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~~~~~
+ ~~~~~~~~~~~~~~~
+ ~~~~~~~~~~
+ ~~~~~
+```
+
+## Install
+
+- from crates.io
+ ```bash
+ crago install aarty
+ ```
+- From aur:
+ ```shell
+ yay -S aarty
+ ```
+
+## Options and arguments
+
+
+```bash
+aarty --help
+```
+```
+A simple CLI tool to convert the images to ASCII art
+
+Usage: aarty [OPTIONS]
+
+Arguments:
+
+ The image to convert to ASCII art
+
+Options:
+ -m, --mode
+ The art mode to use
+
+ [default: normal-ascii]
+
+ Possible values:
+ - normal-ascii: Normal ASCII art
+ - colored: Colored ASCII art, the colors are based on the terminal colors
+
+ --output-method
+ [default: stdout]
+
+ Possible values:
+ - file: Save the ascii art to a file
+ - stdout: Print the ascii art to the terminal
+
+ -c, --characters
+ The character to use for drawing the image (lighter to darker) You can user one character if you uses the color mode
+
+ [default: " .,-~!;:=*&%$@#"]
+
+ -s, --scale
+ The output scale (1 is the original size)
+
+ [default: 4]
+
+ -b, --background
+ The background color to use
+
+ -o, --output