Immich Random Image — display random photos from your Immich library on your dashboards

Share your Projects! Custom Integrations
,
1

Hey everyone! :waving_hand:

I’ve been using Immich for a while, and recently immich-home-assistant by @outadoc broke. Immich v3.x no longer works and this integration hasn’t had updates in the last 2 years. Since I became reliant on that plugin for my dashboard and NVR previews, I rewrote the integration from scratch with a few enhancements I was missing.

Immich Random Image is a custom HACS integration that pulls a random image from your Immich v3+ instance and serves it as a standard Home Assistant image entity - perfect for picture cards, dashboard backgrounds, or photo displays on wall tablets. It let’s you select from albums (1 or more) and if none are specified should just select any image at random. Think of it like Google’s Nest Display, but open source and private on your LAN.

Features

  • Fully random image from your entire Immich library via the Immich API’s endpoints
  • Random image from specific albums - pick one or multiple albums
  • Configurable refresh interval - new image every 5 minutes by default (adjustable from 1 second to 24 hours)
  • On-demand refresh button - fetch a new image instantly from your dashboard, can also be used in an automation if needed
  • Dynamic album selection - switch albums from automations via a select entity
  • SSL toggle - works with self-signed certificates for those self-hosters out there that don’t use a custom domain or Let’s Encrypt
  • No external dependencies - uses only aiohttp bundled with Home Assistant

Screenshots

Configuration
Configuration584×697 29.9 KB

Configuration options - server URL, API key, SSL, refresh interval, album selection

Entities
Entities1027×372 7.97 KB

Entities created by the integration

Album selection
Album selection597×346 14.6 KB

Dynamic album picker - change albums from automations

Refresh button
Refresh button588×154 7.44 KB

Press the button to fetch a new random image on demand

Installation

I’ve requested this be added to HACS, but their PR queue is about a month long per their bot. In the meantime, you can add the custom repository as follows:

  1. Add https://github.com/strickdd/ImmichRandomImage as a custom repository (Integration category)
  2. Install “Immich Random Image” from HACS
  3. Restart Home Assistant

If you trust internet links and are OK clicking this one, it saves a few steps and installs directly:

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Setup

  1. Generate a long-lived API key in Immich (Settings > API Keys) with asset.read and search.read permissions
  2. In Home Assistant: Settings > Devices & Services > Add Integration > search “Immich Random Image”
  3. Enter your server URL and API key
  4. Optionally select which albums to pull from

Dashboard Example

# AI generated example.
type: picture-entity
entity: image.immich_random_image
show_state: false
show_name: false
aspect_ratio: "16:9"
fit_mode: contain

Automation Example - Rotate album by time of day

# AI generated example.
alias: "Rotate album by time of day"
trigger:
  - platform: time
    at: "07:00:00"
    id: morning
  - platform: time
    at: "19:00:00"
    id: evening
action:
  - choose:
      - conditions:
          - condition: trigger
            id: morning
        sequence:
          - action: select.select_option
            target:
              entity_id: select.immich_album_selection
            data:
              option: "Vacation 2026"
      - conditions:
          - condition: trigger
            id: evening
        sequence:
          - action: select.select_option
            target:
              entity_id: select.immich_album_selection
            data:
              option: "all"

Links

Tested on Home Assistant 2026.8.0 with Immich v3. Let me know if you run into any issues or have feature requests!