From 9fb6e3707a0070666babb3b53abc41d11fd2e34a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ond=C5=99ej=20Hru=C5=A1ka?= <ondra@ondrovo.com>
Date: Sun, 24 Feb 2019 23:56:02 +0100
Subject: [PATCH] Readme improvements

---
 README.md | 50 ++++++++++++++++++++------------------------------
 1 file changed, 20 insertions(+), 30 deletions(-)

diff --git a/README.md b/README.md
index 9cabd96..4cb593a 100644
--- a/README.md
+++ b/README.md
@@ -20,59 +20,49 @@ The daemon loads its config from a JSON file, an example of which is provided as
 Defaults will be loaded in absence of the config file.
 
 Here is the structure explained (please note that JSON doesn't allow comments,
-this is just for demonstration):
+this is just for the demonstration):
 
 ```
 {  
   // Blacklist config
   "blacklist": {
     // Literal tags to reject
-    "tag": [],
-    
+    "tag": [],    
     // Tag sub-strings to reject (must be a whole word)
-    "tag_partial": ["hip-hop", "hip hop", "rap"],
-    
+    "tag_partial": ["hip-hop", "hip hop", "rap"],    
     // Artists to reject without even checking tags
     "artist": ["Higher Brothers"]
-  },  
-  
+  },    
   // Whitelist config
   "whitelist": {
     // Tags to allow despite e.g. a substring match
-    "tag": [],
-    
+    "tag": [],    
     // Artists to allow unconditionally
     "artist": []
-  },
-  
+  },  
   // Logging - trace, debug, (info), warning, error
-  "logging": "info",
-  
-  // Player names to allow (e.g. when we want to block only Spotify songs)
-  // This does not support multiple players playing at once - always only the first is
-  // handled.
+  // Set to "debug" for more detailed logging (e.g. to see the received
+  // JSON, or the parsed config file) 
+  "logging": "info",  
+  // Player names to allow (e.g. when we want to block only Spotify songs).
+  // This does not support multiple players playing at once - always only
+  //  the first is handled.
   "allowed_players": [
     // spotify player name, as copied from the debug log
     // -> Leave this list empty to allow all players!
     "org.mpris.MediaPlayer2.spotify"
-  ],
-  
+  ],  
   // Min MusicBrainz search score for artist look-up
-  "artist_min_score": 95,
-  
+  "artist_min_score": 95,  
   // Max nr of artists to check per track (limits MusicBrainz request count)
-  "max_artists_per_track": 3,
-  
+  "max_artists_per_track": 3,  
   // Interval in which the daemon probes DBUS for open MPRIS channels
-  "player_find_interval_ms": 2500,
-  
-  // Delay after a skip or allow, e.g. to prevent infinite skip
-  // chain when someone starts a rap playlist and we block the 'rap' tag
-  "cooldown_ms": 500,
-  
+  "player_find_interval_ms": 2500,  
+  // Delay after a skip or allow, e.g. to prevent infinite skip chain
+  // when someone starts a rap playlist and we block the 'rap' tag
+  "cooldown_ms": 500,  
   // Music Brainz API access timeout
-  "api_timeout_ms": 2000,
-  
+  "api_timeout_ms": 2000,  
   // Action to take when the daemon can't figure out if a song is good or not.
   // Default is true; change to false if you REALLY hate rap, but it will 
   // also block good songs by less known artists.