Merge pull request #268 from MiczFlor/develop

Adding Spotify and dynamic cover reload

README.md

@@ -1,11 +1,12 @@
 # Phoniebox: the RPi-Jukebox-RFID
 
-A contactless jukebox for the Raspberry Pi, playing audio files, playlists, podcasts, web streams triggered by RFID cards. All plug and play via USB, no soldering iron needed. Update: if you must, it now also features a howto for adding GPIO buttons controls.
+A contactless jukebox for the Raspberry Pi, playing audio files, playlists, podcasts, web streams and spotify triggered by RFID cards. All plug and play via USB, no soldering iron needed. Update: if you must, it now also features a howto for adding GPIO buttons controls.
 
 *Important update news*
 
-* **Phoniebox 1.1.6 released** Adding *recursive folder playout* and *recording* to the Phoniebox. With version 1.x we switched the audio player to `mpd`, added *resume play* for audiobook lovers, RFID switch for *wifi off*, new *player interface*, *random* and *repeat*. At this stage the *recursive* playout only works in the web app, not RFID cards. (2018-10-08)
-* **Upgrade** if you are looking for *how to upgrade* please check out [UPGRADE.md](docs/UPGRADE.md) - and if you found out something that should go there, please create a pull request. (2018-10-08)
+* **Phoniebox 1.1.7 released** [Adding **Spotify** to your Phoniebox](docs/SPOTIFY-INTEGRATION.md). See the next bulletpoint for information on how you can improve this new feature. (2018-10-18)
+* **Spotify integration needs you** I invite everybody to use our [spotify thread](https://github.com/MiczFlor/RPi-Jukebox-RFID/issues/18) to post improvements regarding this feature. You might also want to [improve the documentation on *Spotify integration*](docs/SPOTIFY-INTEGRATION.md) and create pull requests so I can merge this with the core..
+* **Upgrade** if you are looking for *how to upgrade* please check out [UPGRADE.md](docs/UPGRADE.md) - and if you found out something that should go there, please create a pull request. (2018-10-18)
 * **One Line Install Script** As of version 1.x there is a much simpler install procedure: copy and paste one line into your terminal and hit *enter*. Find out more about the [one-line Phoniebox install script](docs/INSTALL-stretch.md#oneLineInstall). (2018-08-18)
 * **Podcasts!** More for myself than anybody else, I guess, I added the [podcast feature for Phoniebox](docs/MANUAL.md#podcasts) (2018-05-09)
 * **Bleeding edge: `develop` branch** The maintenance with a growing contributor team (kudos!) got complicated. I introduced the branch `develop` which is where all new stuff is happening before merged to `master`. (2018-08-30)
@@ -115,6 +116,5 @@ Here is a list of equipment needed. Chances are that you will find most of it in
 * [Raspberry Pi 3 Model B ](http://amzn.to/2ku0PU7) | You might be surprised how easy and affordable you can get an RPi second hand. Think about the planet before you buy a new one.
 * RFID Card Reader (USB): [Neuftech USB RFID Reader ID](https://amzn.to/2RrqScm) using 125 kHz - make sure to buy compatible cards, RFID stickers or key fobs working with the same frequency as the reader. **Important notice:** the hardware of the reader that I had linked here for a long times seems to have changed and suddenly created problems with the Phoniebox installation. The reader listed now has worked and was recommended by two Phoniebox makers (2018 Oct 4). I can not guarantee that this will not change and invite you to give [RFID Reader feedback in this thread](https://github.com/MiczFlor/RPi-Jukebox-RFID/issues/231).  
 * [USB Stereo Speaker Set (6 Watt, 3,5mm jack, USB-powered) black](http://amzn.to/2kXrard) | This USB powered speaker set sounds good for its size, is good value for money and keeps this RPi project clean and without the need of a soldering iron :)
-* RFID Card Reader (USB): [Neuftech USB RFID Reader ID](https://amzn.to/2RrqScm) using 125 kHz - make sure to buy compatible cards, RFID stickers or key fobs working with the same frequency as the reader. **Important notice:** the hardware of the reader that I had linked here for a long times seems to have changed and suddenly created problems with the Phoniebox installation. The reader listed now has worked and was recommended by two Phoniebox makers (2018 Oct 4). I can not guarantee that this will not change and invite you to give [RFID Reader feedback in this thread](https://github.com/MiczFlor/RPi-Jukebox-RFID/issues/231).
 * [USB A Male to Female Extenstion Cable with Switch On/Off](http://amzn.to/2hHrvkG) | I placed this USB extension between the USB power adapter and the Phoniebox. This will allow you to switch the Phoniebox on and off easily.
 * [USB 2.0 Hub 4-port bus powered USB Adapter](http://amzn.to/2kXeErv) | Depending on your setup, you will need none, one or two of these. If you are using the external USB powered speakers, you need one to make sure the speakers get enough power. If you want to use the additional USB soundcard and have an older RPi, you might need a second one to make sure you can connect enough devices with the RPi.

docs/GPIO-BUTTONS.md

@@ -16,12 +16,8 @@ Many, many fellow jukebox tweakers have contacted me to push
 the envelope a bit further and add buttons to the jukebox.
 Buttons to change the volume and skip between tracks in a playlist.
 
-Right now (12th Dec 2017) I still have to get my soldering iron
-out of the shelf and try this myself. Until then, what I have done here
-is compiling and editing howto mails and docs I got sent.
-I would love to hear feedback and get pull requests to improve 
-this documentation. So if you are successful, give back to the project
-by sharing your knowledge.
+So this documentation is entirely community driven, I am only editing and asking for
+confirmation that this works :)
 
 Enough said, here we go.
 
@@ -52,13 +48,14 @@ On the above image you can also see the pin numbering, in this case containing b
 
 The script for the GPIO buttons we are using have been provided by Andreas aka [hailogugo](https://github.com/hailogugo). He also sent the picture above and has a working version of the GPIO button solution. Pin numbers and functionality in this example connect as such:
 
-| Board | GPIO (BCM) | Function |
-| --- | --- | --- |
-| 15 | 22 | Volume up |
-| 16 | 23 | Volume down |
-| 11 | 17 | Next track |
-| 13 | 27 | Previous track |
-| 37 | 26 | Play/Pause |
+* **Volume Down** GPIO19 (PIN35) and GND (PIN39)
+* **Volume Up** GPIO16 (PIN36) and GND (PIN34)
+* **Play/Pause/Halt (or how you call it)** GPIO21 (PIN40) and GND (PIN25)
+* **Next** GPIO26 (PIN37) and GND (PIN30)
+* **Previous** GPIO20 (PIN38) and GND (PIN20)
+* **Shutdown (you need to hold button for 2 secs for shutdown)** GPIO3 (PIN5) and GND (PIN6)
+
+**!!! IMPORTANT Only when using the above listed pins for wiring you will be able to power-up the Raspberry PI from firmware halt. !!!**
 
 ### Circuit example(s) for the button wiring
 

docs/MANUAL.md

@@ -556,6 +556,13 @@ $ sudo reboot
 
 ## <a name="faqAudioNotWorking"></a>Audio is not working
 
+Before you file a ticket on github, please read this section and when you file it, please answer these questions:
+
+* what version are you on? Type in terminal `cat /home/pi/settings/version`
+* what soundcard are you using?
+* does your Raspberry Pi play any sound?
+* did the audio work and then you connected a sound card and now it doesn't?
+
 This might occur if you are using external sound cards like *pHat BEAT* or the like. I split this into two parts: a) sound did never work and b) sound worked once, now, with a new soundcard, it doesn't.
 
 **a) Audio never worked**