summaryrefslogtreecommitdiff
path: root/spotify-widget
diff options
context:
space:
mode:
authorstreetturtle <streetturtle@users.noreply.github.com>2017-06-21 16:42:50 -0400
committerGitHub <noreply@github.com>2017-06-21 16:42:50 -0400
commit87e5a80aefa3ff09f7602386718724898bb75521 (patch)
treeed9ab054f9b61ee82f6107daa08b398679647de3 /spotify-widget
parent4444a7581364833474fbad05dbb80406abdecd54 (diff)
Update README.md
Diffstat (limited to 'spotify-widget')
-rw-r--r--spotify-widget/README.md22
1 files changed, 20 insertions, 2 deletions
diff --git a/spotify-widget/README.md b/spotify-widget/README.md
index 1454588..df84927 100644
--- a/spotify-widget/README.md
+++ b/spotify-widget/README.md
@@ -1,11 +1,22 @@
# Spotify widget
-This widget displays currently playing song on [Spotify for Linux](https://www.spotify.com/download/linux/) client: ![screenshot](./spo-wid-1.png).
+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:
-If clicked plays/pauses the music.
+ - 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. 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)
@@ -22,3 +33,10 @@ s.mytasklist, -- Middle widget
spotify_widget,
...
```
+
+## 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:.