¡Fotos en la Nube Local! Cómo Integrar Immich en Home Assistant

¿Qué es Immich?

En pocas palabras, Immich es una solución de gestión de fotos y vídeos autohospedada. Es la alternativa perfecta a Google Photos porque:

Es local: Tus fotos viven en tus propios discos.
Es rápido: Interfaz web y app móvil extremadamente fluidas.
Privacidad total: Tú tienes el control absoluto de tus datos.

Si aún no lo tienes instalado, te recomiendo pasar por mi guía de instalación de Immich antes de continuar con esta integración.

Paso 1: Instalación de la Integración (vía HACS)

Para conectar ambos mundos, utilizaremos una integración personalizada disponible en GitHub. Tienes dos formas de añadirla a tu Home Assistant:

Opción A: Repositorio Personalizado en HACS

Ve a HACS > Integraciones.
Haz clic en los tres puntos (esquina superior derecha) > Repositorios personalizados.
Pega la URL: https://github.com/outadoc/immich-home-assistant
Selecciona la categoría Integración y haz clic en Añadir.

Opción B: Enlace Directo (Más rápido)

Si tienes configurado el "My Home Assistant", puedes usar este enlace directo: 👉 Añadir Integración de Immich (clic en "Open Link" y luego en "Añadir").

¡Importante! Una vez descargada la integración, debes reiniciar Home Assistant para que los cambios surtan efecto.

Paso 2: Configuración y Obtención de la API Key

Una vez reiniciado, ve a Ajustes > Dispositivos y Servicios > Añadir Integración y busca "Immich". Te pedirá dos datos clave:

URL del Host: La dirección de tu servidor Immich (ej. http://192.168.1.50:2283/). Asegúrate de que termine en barra /.
API Key:
- Entra en tu instancia de Immich.
- Ve a Account Settings (tu perfil) > API Keys.
- Haz clic en New API Key, dale un nombre (ej. "Home Assistant") y cópiala.

Pega la clave en Home Assistant y ¡listo! Ahora tendrás una entidad (por defecto mostrará tus fotos favoritas) que genera una imagen aleatoria cada cierto tiempo.

Paso 3: Crear un Panel de "Marco de Fotos"

Para ver tus fotos en un panel dedicado o en tu Wall Panel, usaremos el siguiente código YAML. Este ejemplo crea una vista tipo panel con una relación de aspecto 16:9.

yaml

type: panel
title: Photo frame
path: photo-frame
icon: mdi:image-frame
subview: true
cards:
  - type: picture-entity
    entity: image.immich_favorite_image
    show_state: false
    show_name: false
    aspect_ratio: "16:9"
    fit_mode: contain

Pro Tip: Puedes configurar la integración para añadir álbumes específicos, pero recuerda que añadir demasiados puede consumir más recursos de tu servidor. ¡Úsalo con cabeza!

Paso 4: Enviar tus fotos a un Chromecast (Casting)

Si quieres que tus fotos aparezcan automáticamente en una Smart TV o pantalla inteligente, puedes llamar a este servicio desde una automatización o desde las Herramientas para desarrolladores:

yaml

  action: cast.show_lovelace_view
  data:
    entity_id: media_player.dispositivo
    dashboard_path: lovelace
    view_path: photo-frame

(Asegúrate de cambiar media_player.tu_dispositivo_chromecast por el ID real de tu dispositivo).

Conclusión

Integrar Immich con Home Assistant no solo le da un toque estético a tu casa, sino que aprovecha al máximo tu servidor de fotos local. Ya sea como protector de pantalla en tu salón o como carrusel de recuerdos en tu cocina, los resultados son espectaculares.

Enlaces de interés: