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
- Date filter: last 7 / 30 / 365 days, this month, this year, On this day memories
- Order modes: random, album order, newest taken, oldest taken, newest added, oldest added
- Capture date and upload date exposed as camera attributes (with paired-photo support)
- Pause switch holds the current slide indefinitely
- Manual "Next slide" button still works while paused
- Survives Home Assistant restarts
- Smooth slide transitions rendered in the browser, so they stay buttery even on lower-end hardware
- Effects:
random,none,fade,slide-left,slide-right,slide-up,slide-down,wipe-left,wipe-right,zoom randompicks a different effect per slide (and avoids repeating the previous one)- Configurable duration and CSS easing
- Aspect ratio + fill mode inheritance from the camera entity (cover / contain / blur backdrop)
| 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 |
| Number | Image cache size | 75 | 50-1000 (MB) | Memory budget for downloaded image data (per album) |
| 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 | random | random, album_order, newest_taken, oldest_taken, newest_added, oldest_added | Slide ordering behavior |
| Select | Aspect ratio | 16:9 | 16:9, 4:3, 1:1, 9:16, and more | Canvas aspect ratio |
| Select | Max resolution | 4K (2160p) | 480p, 720p, 1080p, 1440p, 4K (2160p), original | Cap output resolution by short edge; use original to render at native size |
| Select | Date filter | off | off, last_7_days, last_30_days, last_365_days, this_month, this_year, on_this_day | Restrict the slideshow to a date window based on photo capture date |
| Text | Pair divider color | #FFFFFF | Hex, named colors, transparent | Divider color between paired images |
| Switch | Pause slideshow | off | on / off | Hold the current frame; advances pause until turned off |
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 |
| Image cache usage (diagnostic) | Current download cache size in MB |
The slideshow camera exposes per-frame metadata as attributes (use with state_attr('camera.x', '<name>') in templates):
| Attribute | Type | Description |
|---|---|---|
album_title |
string | Title of the source album |
media_count |
int | Photos in the active playlist (after date filter) |
media_count_total |
int | Total photos available before filtering |
current_index |
int | Index of the current slide |
current_filename |
string | null | Source filename when known |
current_url |
string | null | URL of the current slide |
current_is_portrait |
bool | null | Orientation of the current slide |
captured_at |
string | list | null | ISO-8601 capture date. List of [primary, partner] when paired (top/left first) |
captured_at_primary |
string | null | Capture date of the primary image only |
uploaded_at |
string | null | ISO-8601 date when added to the album (Google Photos only) |
byte_size |
int | null | Original file size in bytes (Google Photos only) |
paused |
bool | Whether the slideshow is paused |
date_filter |
string | Active date filter mode |
frame_id |
int | Monotonic counter incremented on every committed slide. Used by the card to detect new frames |
The integration ships with a custom Lovelace card that does the slide-to-slide transition entirely in the browser. The server only renders one still per slide change; the card cross-fades in CSS, which the browser composites on the GPU. Result: a smooth dissolve on a Pi 4, even with several albums on screen.
The card is registered automatically when the integration loads; you do not need to add it as a HACS frontend repository or configure a Lovelace resource manually. After installing or upgrading, hard-refresh the dashboard once (Ctrl+Shift+R) so the browser picks up the script.
A visual editor is available - pick Album Slideshow from the card picker in Lovelace and the form will appear automatically.
type: custom:album-slideshow-card
entity: camera.album_slideshow_living_roomtype: custom:album-slideshow-card
entity: camera.album_slideshow_living_room
transition: random # random | none | fade | slide-left
# | slide-right | slide-up | slide-down
# | wipe-left | wipe-right | zoom
duration: 800 # ms; CSS transition length
easing: ease-in-out # any CSS timing function (ease, linear, cubic-bezier(...))
aspect_ratio: 16/9 # CSS aspect-ratio value (16/9, 4/3, 1/1, auto)
fit: auto # auto | cover | contain
# auto inherits the camera's fill_mode (cover / contain / blur)
background: '#000' # color shown behind contained images
tap_action: none # none | more-infotransition: randompicks a different effect per slide and avoids repeating the previous one.fit: autoreads the camera'sfill_modeattribute.blurrenders the slide ascontainplus a blurred backdrop layer behind it.- Every slide commit increments the camera's
frame_idattribute. The card cache-busts the camera proxy URL with that value, so the browser refetches a fresh JPEG on every change instead of serving a stale cached image. - If the entity is unavailable, the card shows a "Camera not ready" placeholder.
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.
- Public shared albums only (link sharing must be enabled)
- Up to 20,000 photos per album
- Videos are skipped
- Internet connection required
- Relies on Google's public web endpoints; if Google changes them, the integration falls back to a 300-photo limit until the scraper is updated
- The last successful album fetch is cached to disk; if a refresh fails or returns no photos, the slideshow keeps running with the cached list
- Images only
- No video support
If you enjoy this card and want to support its development:
