explaingit

helloseyedjafari/google-photos-homey-widget

Analysis updated 2026-05-18

0JavaScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A Homey Pro dashboard widget that turns a public Google Photos album link into a live slideshow, with no Google API keys or account setup needed.

Mindmap

mindmap
  root((Photos Slideshow))
    What it does
      Reads public album link
      Streams photo URLs
      Survives idle screen
    Tech stack
      JavaScript
      Homey Apps SDK
    Use cases
      Dashboard slideshow
      No API keys
      Auto re-scan album
    Audience
      Homey Pro owners

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Show a public Google Photos album as a rotating slideshow on a Homey dashboard

USE CASE 2

Keep a slideshow accurate after the dashboard screen dims or idles

USE CASE 3

Filter which photos display using shuffle, newest, or oldest order

USE CASE 4

Update slideshow contents automatically as new photos are added to the album

What is it built with?

JavaScriptNode.jsHomey Apps SDK

How does it compare?

helloseyedjafari/google-photos-homey-widget00kaku/gallery-slider-block0xkinno/vellum
Stars00
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-05-19
MaintenanceDormant
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min

Requires a Homey Pro device on firmware 12.3.0 or later, does not work on Homey Cloud.

In plain English

This project is a widget for the Homey Pro smart home dashboard that turns a public Google Photos album into a live slideshow, using nothing more than a shared album link. There is no need to copy photos into a special folder, no Google API setup, and no API keys to configure before it works. You paste a public Google Photos share link into the widget's settings, and it streams the photos directly from Google's servers, only ever holding on to their web addresses rather than downloading or duplicating anything locally. Because Google removed certain official photo API access in 2025, this widget deliberately avoids that official API altogether and instead reads the same public page a regular browser would see when visiting a shared album. A key design goal is that the slideshow keeps working correctly even after the dashboard screen has been dimmed or gone idle for a while, which the developer notes is a common problem with other dashboard widgets. It does this by calculating which photo should currently be showing directly from the system clock, rather than relying on a timer that might have paused, so the instant the screen wakes up it simply jumps to the correct photo instead of losing its place in the sequence. Settings let you choose how long each photo displays, whether they play in shuffle order or by date, whether photos are cropped to fill the widget or shown in full with letterboxing, whether transitions crossfade, and how often the widget checks the album for newly added photos. Only photos are shown, videos in the album are automatically skipped, and only the first roughly three hundred photos in an album are available due to how the public album page loads its content in a browser. Installation requires a Homey Pro device on a recent firmware version, along with the Homey command line tool used to log in and install the app onto your device. The project notes that this only works on Homey Pro hardware, not Homey Cloud, since it depends on features only the Pro device supports.

Copy-paste prompts

Prompt 1
Help me install this widget on my Homey Pro using the Homey CLI.
Prompt 2
Explain how this widget keeps showing the right photo after the dashboard screen goes idle.
Prompt 3
Walk me through the slideshow settings like transition, order, and re-scan interval.
Prompt 4
Show me how this widget parses a public Google Photos share page for image URLs.

Frequently asked questions

What is google-photos-homey-widget?

A Homey Pro dashboard widget that turns a public Google Photos album link into a live slideshow, with no Google API keys or account setup needed.

What language is google-photos-homey-widget written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, Homey Apps SDK.

How hard is google-photos-homey-widget to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is google-photos-homey-widget for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.