album-slideshow v0.0.2

balenablocks/photo-gallery

A blocks that allows you to display a photo slideshow on a webpage over a web server. Out of the box you can use Google Photo Albums, Dropbox Photo Album and Apple Photos. The images are downloaded automatically and auto updated in case of changes.

Supported Albums

Google Photos Albums

Go to https://photos.google.com and select the album that you want to share.

Click in the share button, click in the Create link button and copy the the url.

Dropbox Photo Albums

On the dropbox website, go to the folder that contains the photos and click on Share Folder and then Copy link. This will the URL you will need to add to balenaCloud.

Apple iCloud Photo Album

Create a photo album and copy the share url, similar to https://www.icloud.com/sharedalbum/#ALBUM-ID

USB drive Photo Album

Place your photos on a USB stick and plug it into the Raspberry Pi. Each time all previous existing photos will be removed and replaced by the new ones.

• Set GALLERY_URL to USBDRIVE to use this mode.
• Make sure to update CRON_SCHEDULE accordingly or else image changes will only be picked up at reboot.

Usage

docker-compose.yml

version: "2.1"
services:
  photos:
    privileged: true
    restart: always
    image: balenablocks/photo-gallery:<arch>
    ports:
      - "8888"

e.g For running on Raspberry Pi 3B+ which is armv7hf use image:balenablocks/photo-gallery:armv7hf

You can also set your docker-compose.yml to build a Dockerfile.template file, and use the build variable %%BALENA_ARCH%% so that the correct image is automatically built for your device.

docker-compose.yml

version: "2.1"
services:
  photos:
    privileged: true
    restart: always
    build: ./
    ports:
      - "8888"

Dockerfile.template

FROM balenablocks/photo-gallery:%%BALENA_ARCH%%

Supported Architectures

• armv7hf
• rpi
• aarch64
• amd64

Setting up the photo album

• On balenaCloud, go to Device variables D(x) and add the following:

* Only available for iCloud photos

Note that after some performance tests on the Raspberry Pi 2 & 3, the combination of GALLERY_IMAGE_STYLE = contain and GALLERY_EFFECT = fade or kenburns can make the transition effects choppy.