Update spotify.md

_widgets/spotify.md

@@ -4,23 +4,30 @@ layout: page
 
 # Spotify widget
 
-This widget displays currently playing song on [Spotify for Linux](https://www.spotify.com/download/linux/) client: ![screenshot](https://github.com/streetturtle/AwesomeWM/blob/master/spotify-widget/spo-wid-1.png?raw=true).
+This widget displays currently playing song on [Spotify for Linux](https://www.spotify.com/download/linux/) client: ![screenshot](./spo-wid-1.png) and consists of two parts: 
+
+ - status icon which shows if music is currently playing
+ - artist and name of the current song playing
+
+## Controls
+
+ - left click - play/pause
+ - scroll up - play next song
+ - scroll down - play previous song
+
+## Dependencies
 
 Note that widget uses the Arc icon theme, so it should be [installed](https://github.com/horst3180/arc-icon-theme#installation) first under **/usr/share/icons/Arc/** folder.
 
+Also this widget uses the output of the **spotify_stat** script which could be found in the widget folder.
+
 ## Installation
 
-First you need to have spotify CLI installed. To do it put following file under **/usr/local/bin** and make it executable:
-
-```bash
-git clone https://gist.github.com/fa6258f3ff7b17747ee3.git
-sudo mv ./fa6258f3ff7b17747ee3/sp /usr/local/bin/
-sudo chmod +x /usr/local/bin/sp
-```
+First you need to have spotify CLI installed. Here is how you can do it (except widget part): [pavelmakhov.com/2016/02/awesome-wm-spotify](http://pavelmakhov.com/2016/02/awesome-wm-spotify) 
 
 To use this widget put **spotify.lua** under **~/.config/awesome/** and add it in **rc.lua**:
 
-{% highlight lua %}
+```lua
 require("spotify")
 ...
 s.mytasklist, -- Middle widget
@@ -29,4 +36,12 @@ s.mytasklist, -- Middle widget
 		...
         spotify_widget,
 		...      
-{% endhighlight %}
+```
+
+## Troubleshooting
+
+_Status icon (play/pause) is not shown_:
+ - make **spotify_stat** script executable (by `sudo chmod +x spotify_stat`) and run it in terminal, output should be either `RUNNING` or `CORKED`;
+ - the **spotify_stat** script is called by **spotify.lua** so make sure that `get_spotify_status_cmd` in **spotify.lua** contains the right path to the script;
+ - create an issue :octocat:.
+