diff --git a/README.md b/README.md
index eddadc6563f5ac40b305d1e4a5c8f3d4c4f95fa3..b57506ce9d81c54daf8dfdf03f0f977ad7d3322f 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,80 @@
 # Shell Pics
 
+This is a ZSH shell config aimed to be used on Pics server.
+
+![General preview](https://storage.galerie.pics/geek/oh-my-pics.png "ZSH config preview")
+
+## Install ZSH
+
+```shell
+sudo apt install zsh
+```
+
+## One step installation
+
+#### Clone repository
+
+```shell
+git clone https://gitlab.viarezo.fr/2019hugueta2/shell-pics ~/shell-pics
+```
+
+#### Start installation
+
+Do **not** install as **sudo**.
+
+```shell
+~/shell-pics/install.sh
+```
+
+#### Follow instructions
+
+
+#### Remove installation folder
+
+```shell
+rm -r ~/shell-pics
+```
+
+
+## Set up your terminal
+
+
+You'll need to install a ***Powerline*** compatible font (**on your personal computer**).
+
+### On Linux & MacOs
+
+```shell
+git clone https://github.com/powerline/fonts.git
+./font/install.sh
+```
+
+### On Windows
+
+On any shell run :
+```shell
+cd $HOME
+git clone https://github.com/powerline/fonts.git
+```
+
+Then by using **Powershell ad Administrator** run :
+```shell
+cd $HOME\fonts
+Set-ExecutionPolicy Bypass
+```
+
+Confirm (y) and then :
+```shell
+.\install.ps1
+```
+
+When the installation is complete :
+```shell
+Set-ExecutionPolicy Default
+```
+
+### Select your font
+
+And then you have to select a ***Powerline*** compatible font ( ***'for Powerline'*** ). Open **Preferences > Profiles > Text > Change Font** in your terminal.
+
+![Change Font](https://storage.galerie.pics/geek/powerline-font.png "Change Font")
+