diff --git a/README.md b/README.md
index c7c30bf..90a80a5 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,45 @@
-# Synology_HDD_db
-Add your HDD, SSD and NVMe drives to your Synology's compatible drive database
+# Synology HDD db
+
+<a href="https://hits.seeyoufarm.com"><img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2F007revad%2FSynology_HDD_db&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=hits&edge_flat=false"/></a>
+
+### Description
+
+Add your HDD, SSD and NVMe drives to your Synology's compatible drive database.
+
+The script works in DSM 7 and DSM 6.
+
+#### What the script does:
+
+* Gets a list of the HDDs, SSDs and NVMe drives installed in your Synology NAS.
+* Gets each drive's model number and firmware version.
+* Checks if each drive is already in the Synology's compatible-drive database.
+* Adds any missing drives to the Synology's compatible-drive database.
+
+
+**Planned updates:** 
+* Detect any connected expansion units and get the model(s) and edit the correct expansion unit db files.
+  * Or add support for users to specify their expansion unit model(s) as arguments.
+  * Or maybe use the shotgun approach and update all expansion unit db files.
+* Add support for SAS drives? Are SAS drives listed as /dev/sata# or /dev/sas# ?
+
+#### Running the script
+
+You can either run the script in a shell, or add a "User defined script" task to Synology's Task Scheduler to run as root.
+
+```YAML
+sudo /path-to-script/syno_hdd_db.sh
+```
+
+<p align="leftr"><img src="images/syno_hdd_db2.png"></p>
+
+**Note:** Replace /path-to-script/ with the actual path to the script on your Synology.
+
+If you run the script with the -showedits flag it will show you the changes it made to the Synology's compatible-drive database. Obviously this is only useful if you run the script in a shell.
+
+```YAML
+sudo /path-to-script/syno_hdd_db.sh -showedits
+```
+
+**Note:** Replace /path-to-script/ with the actual path to the script on your Synology.
+
+<p align="leftr"><img src="images/syno_hdd_db.png"></p>