Turn a Google Photos shared album or local/NAS folder into a fully controllable Home Assistant camera slideshow.
Clean. Flexible. Fully runtime configurable. Designed for dashboards.
Album Slideshow creates a camera entity that automatically cycles through images from:
- Google Photos shared albums
- Local folders
- NAS mounted directories
All behavior is exposed as Home Assistant entities. Adjust everything live without YAML edits or restarts.
- Auto advancing camera entity
- Configurable slide interval
- Manual next slide button
- Album refresh control
- Google Photos shared albums
- Local folder paths
- NAS mounted directories
- Optional recursive scanning
| Mode | Behavior |
|---|---|
| Pair | Display two mismatched images side by side |
| Single | Render single image using selected fill mode |
| Avoid | Skip mismatched images |
| Mode | Behavior |
|---|---|
| Blur | Image over blurred background |
| Cover | Crop to fill canvas |
| Contain | Fit inside canvas with bars |
- Configurable aspect ratio such as 16:9, 4:3, 1:1, 9:16
- Shuffle or album order
- Pair divider size/color control
The following entities allow you to adjust slideshow behavior without restarting Home Assistant.
| Entity Type | Name | Default | Accepted Values | Description |
|---|---|---|---|---|
| Number | Slide interval | 60 | Any positive integer (seconds) | Time between slides |
| Number | Album refresh | 24 | Any positive integer (hours) | How often album contents refresh |
| Number | Pair divider size | 8 | 0-64 (px) | Width of divider between paired images |
| Select | Fill mode | blur | blur, cover, contain | How images fill the canvas |
| Select | Orientation mismatch | pair | pair, single, avoid | Handling of portrait and landscape mismatch |
| Select | Order mode | shuffle | shuffle, album | Slide ordering behavior |
| Select | Aspect ratio | 16:9 | 16:9, 4:3, 1:1, 9:16, and more | Canvas aspect ratio |
| Text | Pair divider color | #FFFFFF | Hex, named colors, transparent | Divider color between paired images |
Album Slideshow Camera is available in HACS.
- Download the latest release
- Copy
custom_components/album_slideshow
into
config/custom_components/
- Restart Home Assistant
- Add the integration from Devices & services
- Open a shared Google Photos album
- Copy the shared link such as
https://photos.app.goo.gl/... - Add the integration
- Paste the link
Use any folder accessible to Home Assistant.
Helpful path mappings:
| Input | Resolves To |
|---|---|
/local/... |
/config/www/... |
media/... |
/media/... |
media/local/... |
/media/... |
For NAS:
- Mount it first
- Use the mounted path
Each album you configure creates the following entities in Home Assistant.
| Entity | Description |
|---|---|
| Slideshow camera | The live slideshow feed rendered according to your current settings |
| Entity | Description |
|---|---|
| Next slide | Immediately advances to the next image |
| Refresh album | Re-fetches album contents |
| Entity | Description |
|---|---|
| Album title | Title of the source album |
| Media count | Number of images currently available |
To remove visible spacing between paired images:
- Set Pair divider color to
transparent - Keep divider size greater than
0
Also accepted values:
noneclearrgba(0,0,0,0)transperantcommon misspelling
When transparency is used, the integration outputs PNG to preserve alpha.
- Shared albums typically return only about 300 photos
- This is an upstream API limitation
- Videos are skipped
- Internet connection required
- Images only
- No video support
If you enjoy this card and want to support its development:
