spacemacs/layers/+music/spotify/README.org

#+TITLE: Spotify layer

#+TAGS: layer|music

[[file:img/spotify.png]]

* Table of Contents                     :TOC_5_gh:noexport:
- [[#description][Description]]
  - [[#features][Features:]]
- [[#install][Install]]
- [[#spotify-web-api-authentication-when-using-search-with-ivy][Spotify Web API authentication when using search with Ivy]]
- [[#key-bindings][Key bindings]]

* Description
This layer integrates an online music service into Spacemacs.

** Features:
- Support for listening to music from within Emacs via [[https://www.spotify.com][Spotify]].

* Install
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =spotify= to the existing =dotspacemacs-configuration-layers= list in this
file.

* Spotify Web API authentication when using search with Ivy
You'll need to [[https://developer.spotify.com/my-applications][register an application]] in Spotify in order to obtain a client id
and a client secret. Then, you'll have to set the variables
=counsel-spotify-client-id= and =counsel-spotify-client-secret= variables with
your credentials to start using the search feature.

* Key bindings

| Key binding   | Description              |
|---------------+--------------------------|
| ~SPC a m s p~ | Play or pause Spotify    |
| ~SPC a m s n~ | Go to the next track     |
| ~SPC a m s N~ | Go to the previous track |
| ~SPC a m s Q~ | Quit Spotify             |

If [[https://github.com/emacs-helm/helm][Helm]] layer is enabled, you can also use the following binding(s):

| Key binding   | Description            |
|---------------+------------------------|
| ~SPC a m s g~ | Search for a new track |

If [[https://github.com/abo-abo/swiper][Ivy]] layer is enabled, you can also use the following binding(s):

| Key binding       | Description                    |
| ~SPC a m s s a~   | Spotify search artist          |
| ~SPC a m s s A~   | Spotify search album           |
| ~SPC a m s s t~   | Search for a new track         |
| ~SPC a m s s T a~ | Spotify search track by artist |
| ~SPC a m s s T A~ | Spotify search track by album  |