diff --git a/README.md b/README.md
index 16e04441f3e81d4f91090a2ccd5bbbd70eb03b87..4d52893a37454e607997008073093f2e3cab9c46 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,30 @@
-# robot_facial_expression
-## This repository contains an edited version of the baxter facial expression package. Facial expressions are customized to be used on a Tiago robot
+### ROS Visualizer of TIAGo facial expressions on a screen ### 
+
+
+
+#### Package:
+- **face_builder** folder contains all the png images used to build the robot's face.
+- **launch** folder contains the ros launch file
+- **script** folder contains the code to build the face. Most of the code has been got from the work of Bilgehan NAL and just a few things have been edited or removed in order to get it working with the TIAGo.
+
+
+
+## USAGE ###
+
+First you need to run the ros node which builds the robot facial expressions (repo [robot_face_expression](https://github.com/aandriella/robot_face_expression)):
+
+``` 
+ roslaunch robot_face_expression robot_face_expression.launch 
+```
+
+Then you can visualise the different facial expressions by running:
+
+``` 
+ rosrun robot_face_visualizer face_visualizer.py
+```
+
+You can change facial expression and the pupil position in the eyes as follows:
+``` 
+rostopic pub /facial_expression std_msgs/String "data: 'expression'" 
+```
+esxpression can be "sad", "angry", "confused", "happy", "neutral", eyes can be moved with "look_X_Y"