diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b3daca6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# Spotify music downloader
+## Based on https://github.com/migo1271/spotify-ripper
+
+This is not a youtube scrapper. This is a real Spotify music downloader, to mp3 320kb/s 44100, no DRM, with good tags.
+
+**You will need a premium account to Spotify and set your ids in `.login.auth` file**
+
+If you want to use keywords search, you will also need a developer token, set to the same file.
+You can get this token here: https://developer.spotify.com/console/get-search-item/
+
+### Installation
+
+Launch `install.sh script
+
+### Exemples of use
+
+Search keyword and download best match
+```
+./spotify-dl.sh daft punk around the world
+```
+
+Download full album
+```
+./spotify-dl.sh https://open.spotify.com/album/5uRdvUR7xCnHmUW8n64n9y
+```