diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..6abc75e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,18 @@
+# Changelog
+
+- 2015-03-31 
+  - enh: code enhancement, plugin should now work with OSMap too!
+- 2015-03-29 
+  - new: JDownloads 3 support
+  - new: 'downloads' view support
+  - new: installer script (version check)
+- 2015-02-28 
+  - enh: language cleanup
+- 2014-04-28 
+  - enh: code cleanup
+- 2014-01-17 
+  - fix: sub categories
+- 2013-09-27 
+  - new: plugin completely rewritten for Joomla 2.5+ and new JDownloads version
+  - new: public release
+
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..8f536e4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+# Xmap - jDownloads Extension for Joomla
+
+![](https://img.shields.io/static/v1?label=Joomla&message=3.X&style=flat&logo=joomla&logoColor=orange&color=blue)
+![](https://img.shields.io/github/release/z-index-net/joomla-plugin-xmap-jdownloads.svg)
+![](https://img.shields.io/github/downloads/z-index-net/joomla-plugin-xmap-jdownloads/total.svg)
+![](https://img.shields.io/badge/Maintained%3F-no-red.svg)
+![](https://img.shields.io/github/license/z-index-net/joomla-plugin-xmap-jdownloads.svg)
+
+Add support for categories and downloads
+
+### Notes
+**Only works under Joomla! 3 with JDownloads 3**
+
+### Preview
+
+![Screenshot](./screenshots/plg_xmap_com_jdownloads.0.png?raw=true)
+
diff --git a/readme.md b/readme.md
deleted file mode 100644
index e69de29..0000000
diff --git a/screenshots/plg_xmap_com_jdownloads.0.png b/screenshots/plg_xmap_com_jdownloads.0.png
new file mode 100644
index 0000000..996239b
Binary files /dev/null and b/screenshots/plg_xmap_com_jdownloads.0.png differ