diff --git a/README.md b/README.md
index 8aac9385f18bee5b508286ecf6a1681cff063a20..ef4a456494857c48d95c0fdd5fd06bbc9a8fa2cb 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,9 @@
 # FEMBEM
 
-The **fembem** library provides tools for finite element method and boundary integral equation, using **castor** library.
\ No newline at end of file
+The **fembem** library provides tools for finite element method and boundary integral equation, using **castor** library. It's a C++ header only library, divided in two .hpp files :
+- __fem.hpp__ for finite elements tools,
+- __bem.hpp__ for integral formulations using boundary elements. 
+
+Some executable demos are given to detaill fonctionalities in /demo directory. 
+
+**NOTE :** The **castor** library should be fully installed with graphics tools (VTK) and linear algebra (openblas). For more informations, you can refer to installation procedure of the **castor** library.