diff --git a/README b/README
deleted file mode 100644
index 328a8ed4..00000000
--- a/README
+++ /dev/null
@@ -1,8 +0,0 @@
-This is what I consider to be a fairly feature-filled home decor modpack.  
-See the forum thread at 
-https://forum.minetest.net/viewtopic.php?f=11&t=2041 for details about 
-this modpack.
-
-Dependencies: unifieddyes and a Minetest engine build newer than 2017-01-23.
-
-Recommends: signs_lib, windmill, moreblocks, unified_inventory.
diff --git a/README.md b/README.md
new file mode 100644
index 00000000..3b0de423
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+# Minetest Homedecor Modpack  
+
+[![ContentDB](https://content.minetest.net/packages/VanessaE/homedecor_modpack/shields/downloads/)](https://content.minetest.net/packages/VanessaE/homedecor_modpack/)
+
+A fairly feature-filled home decor modpack that is game agnostic.
+
+## About
+
+first class support for:
+
+* Minetest Game
+* Farlands Reloaded
+* Hades
+* Mineclone2, Mineclone5
+
+## Links  
+
+* [Github](https://github.com/mt-mods/homedecor_modpack)
+* [Contentdb](https://content.minetest.net/packages/VanessaE/homedecor_modpack/)
+* [Forums](https://forum.minetest.net/viewtopic.php?f=11&t=2041)
+
+# Setup
+
+required: 
+
+* [Unifieddyes](https://github.com/mt-mods/unifieddyes)
+* [Basic Materials](https://github.com/mt-mods/basic_materials)
+
+optional:
+
+* [Sound Api](https://github.com/mt-mods/sound_api) - note: needed for sound support