diff --git a/.gitignore b/.gitignore
index 31fcefd..9f9d2f2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -11,7 +11,6 @@ Makefile.in
 .*.sw[po]
 *.gcov
 *.gcno
-/README
 /aclocal.m4
 /autom4te.cache/
 /config.cache
diff --git a/README b/README
new file mode 100644
index 0000000..a7639d8
--- /dev/null
+++ b/README
@@ -0,0 +1,28 @@
+Clouseau
+
+Clouseau is a UI inspection tool aimed to debug EFL applications.
+
+Requirements:
+
+  efl (1.20 +)
+
+Compiling:
+
+1. mkdir build
+2. cd build
+3. cmake -DCMAKE_INSTALL_PREFIX=/your_install_path ..
+4. make
+5. (sudo) make install
+
+How to use it?
+
+1. Run efl_debugd on the machine where the program to debug has to run
+2. Run your program
+3. Run clouseau_client -l / -r [port]
+4. Choose the extension you want to use
+5. Choose your application
+
+clouseau_client can run in three modes:
+- locally: it connects to the local daemon (efl_debugd)
+- remotely: you have to establish a connection (SSH...) and to supply the port to use to Clouseau
+- offline: this is for the case you want to visualize a snapshot saved earlier