From 8eb840598b0ccf83c84d9baa23cdb6c7848f9d3a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Beno=C3=AEt=20Harrault?= <benoit@harrault.fr>
Date: Fri, 15 Oct 2021 14:21:53 +0200
Subject: [PATCH] Improve README

---
 README.md  | 31 +++++++++++++++++++------------
 SPOTIFY.md | 16 ++++++++++++++++
 2 files changed, 35 insertions(+), 12 deletions(-)
 create mode 100644 SPOTIFY.md

diff --git a/README.md b/README.md
index 7eb2f6f..ce730c4 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,25 @@
-# spotify
+# Spotify playlist generator
 
-# Register app
+Create fresh playlists from selected top played artists or existing playlists.
 
-<https://developer.spotify.com/dashboard/applications>
+Playlists are generated as public Spotify playlists, with 50 tracks (~3 hours), from your personal Spotify recommendations.
 
-App name:
-    Spotify playlist manager
+## Generate fresh playlist form artists
 
-Add description:
-    Application to help create/update playlists from other playlists or selected artists/tracks.
-    Something like "radios", but more personalized.
+From the list of your top played artists.
 
-Client ID:
-    41597dbeb0b3403caa28e7e428e0c9b2
+-   pick one or several artists in list
+-   click on "generate"
+-   a fresh playlist is generated with recommendations from each artist in pick ones
 
-Client Secret:
-    <hidden>
+You can choose if you want all recommendations, or only the ones with picked artists.
+
+A direct button can help to randomly pick artists.
+
+## Generate fresh playlist from existing playlists
+
+-   pick one or several playlist in list
+-   click on "generate"
+-   a fresh playlist is generated with recommendations from each track in picked playlists
+
+You can choose if you want all recommendations, or only the ones with artists in picked playlists.
diff --git a/SPOTIFY.md b/SPOTIFY.md
new file mode 100644
index 0000000..e78db74
--- /dev/null
+++ b/SPOTIFY.md
@@ -0,0 +1,16 @@
+## Register app
+
+<https://developer.spotify.com/dashboard/applications>
+
+App name:
+    Spotify playlist manager
+
+Add description:
+    Application to help create/update playlists from other playlists or selected artists/tracks.
+    Something like "radios", but more personalized.
+
+Client ID:
+    41597dbeb0b3403caa28e7e428e0c9b2
+
+Client Secret:
+    <hidden>
-- 
GitLab