Update readme
This commit is contained in:
parent
e785d9cf85
commit
e9a68cce45
|
@ -1,9 +1,14 @@
|
|||
# Spotify widget
|
||||
|
||||
This widget displays currently playing song on [Spotify for Linux](https://www.spotify.com/download/linux/) client: ![screenshot](./spo-wid-default.png) and consists of two parts:
|
||||
This widget displays currently playing song on [Spotify for Linux](https://www.spotify.com/download/linux/) client: ![screenshot](./spo-wid-1.png)
|
||||
|
||||
Some features:
|
||||
|
||||
- status icon which shows if music is currently playing
|
||||
- artist and name of the current song
|
||||
- dim widget if spotify is paused
|
||||
- trim long artist/song names
|
||||
- tooltip with more info about the song
|
||||
|
||||
## Controls
|
||||
|
||||
|
@ -24,6 +29,11 @@ It is possible to customize widget by providing a table with all or some of the
|
|||
| `play_icon` | `/usr/share/icons/Arc/actions/24/player_play.png` | Play icon |
|
||||
| `pause_icon` | `/usr/share/icons/Arc/actions/24/player_pause.png` | Pause icon |
|
||||
| `font` | `Play 9`| Font |
|
||||
| `dim_when_paused` | `false` | Decrease the widget opacity if spotify is paused |
|
||||
| `dim_opacity` | `0.2` | Widget's opacity when dimmed, `dim_when_paused` should be set to `true` |
|
||||
| `max_length` | `15` | Maximum lentgh of artist and title names. Text will be ellipsized if longer. |
|
||||
| `show_tooltip` | `true`| Show tooltip on hover with information about the playing song |
|
||||
|
||||
|
||||
### Example:
|
||||
|
||||
|
@ -31,21 +41,29 @@ It is possible to customize widget by providing a table with all or some of the
|
|||
spotify_widget({
|
||||
font = 'Ubuntu Mono 9',
|
||||
play_icon = '/usr/share/icons/Papirus-Light/24x24/categories/spotify.svg',
|
||||
pause_icon = '/usr/share/icons/Papirus-Dark/24x24/panel/spotify-indicator.svg'
|
||||
pause_icon = '/usr/share/icons/Papirus-Dark/24x24/panel/spotify-indicator.svg',
|
||||
dim_when_paused = true,
|
||||
dim_opacity = 0.5,
|
||||
max_length = -1,
|
||||
show_tooltip = false
|
||||
})
|
||||
```
|
||||
|
||||
Gives following widget:
|
||||
Gives following widget
|
||||
|
||||
![screenshot](./spo-wid-custom.png)
|
||||
Playing:
|
||||
![screenshot](./spotify-widget-custom-playing.png)
|
||||
|
||||
Paused:
|
||||
![screenshot](./spotify-widget-custom-paused.png)
|
||||
|
||||
## Installation
|
||||
|
||||
First you need to have spotify CLI installed, it uses dbus to communicate with spotify-client:
|
||||
|
||||
```bash
|
||||
git clone https://gist.github.com/fa6258f3ff7b17747ee3.git
|
||||
cd ./fa6258f3ff7b17747ee3
|
||||
git clone https://gist.github.com/wandernauta/6800547.git
|
||||
cd ./6800547
|
||||
chmod +x sp
|
||||
sudo cp ./sp /usr/local/bin/
|
||||
```
|
||||
|
|
Loading…
Reference in New Issue