diff --git a/README.md b/README.md
index 7d9ab56dd6aaf9e9be0c815141e3bb5b15dd8cae..7fa6ae1063376b1c8b8db2e8daf7b8fede8a6e9e 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,36 @@
 ![CI bagde](https://gitlab.com/xphnx/ameixa/badges/master/build.svg)
 
-Port of TwelF CMTheme for trebuchet, kiss, nova, apex, holo, asus, adw and many more launchers.
+Port of TwelF CMTheme for trebuchet, kiss, nova, apex, holo, asus, adw and many more launchers. A Material Design inspired theme aiming to provide a consistent and minimalistic look to your device.
 
+You can use [Turtl](https://f-droid.org/repository/browse/?fdid=org.xphnx.iconsubmit) for requesting icons. As determining if the icons requested are related to FLOSS apps is a tedious work, currently only [F-droid](https://f-droid.org/) hosted apps are supported.
 
+##### [Changelog](https://gitlab.com/xphnx/twelf_cm12_theme/blob/master/CHANGELOG.md)
 
-[![F-Droid](https://f-droid.org/wiki/images/0/06/F-Droid-button_get-it-on.png)](https://f-droid.org/repository/browse/?fdid=org.xphnx.ameixa)
+
+## Installation
+
+[![Get_it_on_F-Droid.svg](https://gitlab.com/uploads/xphnx/twelf_cm12_theme/a4649863bd/Get_it_on_F-Droid.svg.png)](https://f-droid.org/app/org.xphnx.ameixa)
+
+More info in [**FAQ**] (https://gitlab.com/xphnx/twelf_cm12_theme/wikis/faq)
+
+## Contributions are welcome 
+
+ * If you are looking for an icon template or some howtos, go to the [**WIKI**](https://gitlab.com/xphnx/twelf_cm12_theme/wikis/home)
+ * Check the what [**enhacements**](https://gitlab.com/dashboard/issues?assignee_id=89915) are needed.
+
+## Screenshots
+
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/97c6faf3cad4619e8079327a5e3d3ac4/Screenshot_2015-05-23-07-53-03.png" alt="with a dark background" width="300" />
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/b0ef81d60e8f4470e41cfec54c4a85b0/Screenshot_2015-05-23-21-03-30.png" alt="into apex launcher" width="300" />
+
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/081953c26fe1f8d30276f1d16bb0f672/Screenshot_2015-05-22-10-51-04.png" alt="light background" width="300" />
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/cec2077cb5bb09008b98d7c8681af67c/Screenshot_2015-05-22-23-47-06.png" alt="apps settings" width="300" />
+
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/27787db387074995a36f18c262f4abba/Screenshot_2015-06-09-22-21-20.png" alt="share feneec" width="300" />
+<img src="https://gitlab.com/xphnx/twelf_cm12_theme/uploads/a49b1be4708a70c2e3c554342ba21edb/Screenshot_2015-05-22-23-55-18.png" alt="inside afw++" width="300" />
+
+## License
+
+<img src="https://gnu.org/graphics/gplv3-127x51.png" />
+
+[GPLv3](http://www.gnu.org/licenses/gpl-3.0.html) and other libre or open licenses for the artwork (see [CREDITS](https://gitlab.com/xphnx/twelf_cm12_theme/blob/master/CREDITS.md) for more details)