엔티티와 서비스

프레임 디바이스마다 Home Assistant 디바이스 페이지가 생기고, 컨트롤러가 바꿀 수 있는 모든 것이 엔티티로, 자동화용으로는 immich_frame.* 서비스가 제공됩니다.

주요 엔티티

영역	엔티티
소스 선택	Album select, Albums text (쉼표 구분 다중 선택), Person select, People text, Require All People switch
필터	Date Filter Preset select, Filter Start Date / Filter End Date 날짜 선택, Date Filter text (last-30-days 같은 raw 값), Newest Filter number, Album Order select
프로필	프로필 선택과 아래 프로필 서비스
디스플레이	렌더러 옵션 엔티티 — 시계, 날짜, 날씨, 폰트 크기, 배경 블러, 이미지 메타데이터(촬영 일시, 앨범, 인물, 카메라, EXIF, 위치, 평점, 소유자, 사용자), 진행 바
미디어	Show Videos switch, Show Archived switch, Kiosk Video Mute 버튼
하드웨어 (FreeKiosk)	Display Brightness, Media Volume number; 내비게이션·화면·볼륨 버튼
텔레메트리 (FreeKiosk)	Device Online(연결), Motion(카메라 기기), Screen On, Device Muted, Battery, Battery Charging, WiFi Signal, Light Level, Auto Brightness Active
유지보수	Refresh Albums, Refresh People 버튼, Network Mode select

참고:

• 텔레메트리 엔티티는 FreeKiosk에서 MQTT 또는 REST로 옵니다. MQTT 바인딩이 있으면 Device Online과 Motion이 약 1초 안에 갱신되고(실시간 푸시), 없으면 통합이 30초마다 폴링합니다. Motion은 카메라가 있는 기기에서만 동작합니다.
• 앨범 필터가 없을 때 Album select는 No Album Filter를 표시합니다. 인물 단독 소스 선택을 원하면 인물을 고르기 전에 이것을 먼저 선택하세요.
• Albums / People text 엔티티는 이름 또는 ID를 쉼표로 구분해 받습니다. all은 이름이 있는 모든 인물을 선택하고, 빈 값 또는 none은 필터를 지웁니다.
• immich-kiosk 문서상 require_all_people은 앨범·날짜 범위 같은 다른 소스 버킷과 호환되지 않습니다 — 결정적인 결과가 필요하면 함께 쓰지 마세요.

서비스

모든 서비스는 선택적 device_id를 받습니다 (기본값은 설정된 디바이스).

서비스	주요 필드
immich_frame.set_album	album_id, album_ids, album_name, album_names
immich_frame.set_people	person_id, person_ids, person_name, person_names
immich_frame.set_profile	profile_id (필수)
immich_frame.save_profile	name, profile_id, overwrite (기본 true)
immich_frame.delete_profile	profile_id
immich_frame.refresh_albums	—
immich_frame.refresh_people	—
immich_frame.set_renderer_options	아래 참고
immich_frame.set_network_mode	network_mode: auto / local / external (필수)

set_renderer_options

렌더러 오버라이드 전체를 하나의 서비스로 제어합니다. 필드 그룹:

• 슬라이드쇼: durationSeconds, transition, fadeTransitionDuration, crossFadeTransitionDuration, imageEffect, imageEffectAmount, albumOrder
• 레이아웃: layout, imageFit, backgroundBlur, backgroundBlurAmount, fontSize, frameless
• 시계·날씨: showTime, timeFormat, showAmPm, showSeconds, showDate, dateFormat, clockSource, showWeather, weatherLocation, weatherRotationInterval, weatherShowForecast, weatherShowHumidity, weatherShowWind, weatherShowWindDirection, weatherShowVisibility, weatherShowTemperatureRange, weatherRoundTemperature
• 이미지 메타데이터: showImageDate, imageDateFormat, showImageTime, imageTimeFormat, showAlbumName, showPersonName, showPersonAge, showImageLocation, showImageCamera, showImageExif, showImageDescription (및 설명 스크롤 튜닝), showImageRating, showOwner, showUser, showImageQr, showImageId, showMoreInfo
• 소스·필터: activePersonIds, requireAllPeople, filterDate, filterNewest, showVideos, excludeVideosOver, showArchived
• Kiosk UI: disableNavigation, hideCursor, showProgressBar, progressBarPosition
• 디스플레이 보호: burnInInterval, burnInDuration, burnInOpacity, sleepStart, sleepEnd, sleepIcon, sleepDimScreen, disableSleep

셀렉터를 포함한 전체 필드 목록은 services.yaml에 있습니다.

예제

매일 아침 저장된 프로필로 전환:

alias: Lenovo frame morning profile
trigger:
  - platform: time
    at: "07:00:00"
action:
  - service: immich_frame.set_profile
    data:
      profile_id: morning

주말에는 특정 앨범의 최근 30일 사진만:

alias: Weekend recent photos
trigger:
  - platform: time
    at: "08:00:00"
condition:
  - condition: time
    weekday: [sat, sun]
action:
  - service: immich_frame.set_album
    data:
      album_names: ["Family"]
  - service: immich_frame.set_renderer_options
    data:
      filterDate: last-30-days
      albumOrder: newest

카메라가 있는 액자 앞에 사람이 다가오면 화면 켜기 (FreeKiosk MQTT + Always-on Motion Detection 필요):

alias: Frame screen on motion
trigger:
  - platform: state
    entity_id: binary_sensor.lenovo_frame_motion
    to: "on"
action:
  - service: button.press
    target:
      entity_id: button.lenovo_frame_screen_on

밤에 화면 끄고 아침에 켜기:

alias: Frame screen schedule
trigger:
  - platform: time
    at: "23:00:00"
    id: "off"
  - platform: time
    at: "07:00:00"
    id: "on"
action:
  - service: button.press
    target:
      entity_id: "button.lenovo_frame_screen_{{ trigger.id }}"