How to install and configure screenly on a Raspberry Pi

1. Download the Screenly OSE disk image from github:

   https://github.com/Screenly/screenly-ose/releases/download/0.16/image_2018-11-23-Screenly-OSE-lite.zip
   

2. Unzip the disk image

3. Write the disk image to the SD card. An easy way to do that is with Etcher:

   https://www.balena.io/etcher/
   

4. Create an empty file named 'ssh' at the top-level of the boot partition (the smallest partition on the SD card)

5. Connect the Pi to a TV or computer monitor and power on the Pi

6. An SSID and password will be displayed on the screen. Connect to it.

7. Open a browser and go to the web page displayed on the screen to configure wifi. Configure it to connect to your network.

8. The Pi reboots and displays its ip address on the screen

9. SSH into the Pi using its ip address (user: pi, pw: raspberry). If you're on Windows and don't have an SSH client installed, putty is available here:

   https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
   

10. Change the password for the pi account

    $ passwd
    

11. Switch to the root account

    $ sudo su root
    

12. Change the password for the root account

    # passwd
    

13. Install the python 'requests' module

    # pip install requests
    

14. [Optional] Configure the locale

    # raspi-config
    

15. Exit

    # exit
    $ exit
    

16. Add content to screenly using a web browser, using the ip address that is displayed when the Pi boots

Using physical buttons with the Pi

1. ssh into the Pi

2. Clone Kevin's python scripts

   $ git clone git@github.com:frankdeath/screenly-python.git
   

3. Manually run the button script

   $ cd screenly-python
   $ ./buttons.py
   

4. buttons.py uses these pin definitions by default

   Pin 38 = Forward (normally high)
   Pin 37 = Backward (normally high)
   Pin 39 = Ground
   

5. Wire momentary, normally-open switches between the function pins and ground