# Washer Cycle Finished — notify when the LG washer's wash cycle completes,
# so the wet load gets moved to the dryer before it starts to smell.
#
# The LG ThinQ integration exposes a "Current status" sensor
# (ThinQProperty.CURRENT_STATE) whose raw state becomes a completion key
# (complete / done / end / running_end, all shown as "Done"/"Finished") when
# a cycle finishes; which key depends on the model. The recipe resolves that
# sensor (scoped to lg_thinq, matched by name) and notifies on the
# transition to any of those completion states.
# An optional ``announce_speakers`` role also speaks the alert over TTS.
#
# Note: the current-status sensor exists on several LG appliance types
# (washer, dryer, dishwasher, ...), so on a multi-appliance home the wizard
# may list more than one — the homeowner picks the washer's.
slug: washer-cycle-finished
version: 1.0.0
title: "LG Washer: Cycle Finished"
tagline: Get a push notification the moment your LG washer finishes, so the wet load moves to the dryer before it starts to smell.
description: >-
  Sends a Home Assistant push notification when the LG washer's cycle
  finishes, so you move the load to the dryer promptly instead of
  rediscovering a musty load hours later. Add one or more speakers and it
  also announces the finished cycle out loud. Reads the washer's own status
  from the LG ThinQ integration.
author: Selora AI
released: "2026-07-09"
min_integration_version: "0.12.0"
tags: [laundry, washer, lg-thinq, notifications]
roles:
  # "Current status" run-state sensor. Scoped to lg_thinq and matched on
  # name. Single-select, required. The current-status sensor is shared
  # across LG appliance types, so the homeowner picks the washer's when
  # more than one is offered.
  - id: status_sensor
    title: Washer status sensor
    kind: sensor
    integration: lg_thinq
    match: "current[ _]st"
    min_count: 1
    max_count: 1
    selection: required
    description: >-
      The washer's "Current status" sensor from the LG ThinQ integration.
      If you have more than one LG appliance, pick the washer's.
  # Announcement speakers — optional. When the homeowner picks at least one
  # media player, the recipe also speaks the alert over TTS in addition to
  # the push notification. Leave empty for notification-only.
  - id: announce_speakers
    title: Announcement speakers
    kind: media_player
    min_count: 0
    selection: required
    description: >-
      Optional. Speakers that announce the finished cycle out loud over TTS
      in addition to the push notification. Leave empty to be notified on
      your phone only.
inputs:
  # TTS engine entity for the optional spoken announcement. Auto-resolved by
  # the ``tts_engine`` resolver from the home's configured tts.* entities
  # (picking whichever TTS engine the home has configured) — the wizard
  # never shows this field. ``tts.speak`` works without a paid Home
  # Assistant Cloud subscription. The resolver returns an empty string when
  # the home has no TTS engine; the template then skips the announcement and
  # stays notification-only. The default below is only used by the offline
  # recipe-validation gate, which has no resolver to run; at install the
  # resolver always overwrites it.
  - id: tts_engine
    type: string
    label: Text-to-Speech engine
    description: >-
      Speech engine entity used for the spoken announcement. Resolved
      automatically from the Text-to-Speech engines configured in Home
      Assistant.
    resolver: tts_engine
    default: "tts.piper"
package_files:
  - package/automations/cycle_finished.yaml.j2

{# Washer Cycle Finished — notify when the "Current status" sensor reaches a
   completion state (displayed as "Done"/"Finished"). HA stores the raw enum
   key as the state, and different LG models emit different completion keys
   (complete / done / end / running_end), so the trigger lists them all
   rather than matching the translated label. ``not_from`` drops the
   unavailable/unknown -> completion transition the integration emits when it
   reconnects with a stale finished state, so a reconnect after a restart
   never fires a phantom cycle-finished alert. When the homeowner picked
   speakers, the same alert is announced over TTS.

   mode: single — one completion per cycle. Templates stay on single quoted
   lines so trim_blocks can't swallow following YAML. #}
automation:
  - id: selora_recipe_{{ slug | replace('-', '_') }}_cycle_finished
    alias: "LG Washer Cycle Finished — move to dryer"
    description: >-
      When the washer's status changes to complete, send a push
      notification and, if speakers are configured, announce it.
    mode: single
    trigger:
      - platform: state
        entity_id: {{ roles.status_sensor[0] }}
        not_from:
          - "unknown"
          - "unavailable"
        to:
          - "complete"
          - "done"
          - "end"
          - "running_end"
    action:
      # 1. Push notification to every device registered with HA.
      - service: notify.notify
        data:
          title: "Washer finished"
          message: "The washer has finished. Move the load to the dryer before it starts to smell."
{% if roles.announce_speakers and inputs.tts_engine %}
      # 2. Optional spoken announcement on the configured speakers, via the
      #    auto-resolved TTS engine. tts.speak works without a Home Assistant
      #    Cloud subscription; the speakers go in media_player_entity_id.
      - service: tts.speak
        target:
          entity_id: {{ inputs.tts_engine }}
        data:
          media_player_entity_id:
{% for player in roles.announce_speakers %}
            - {{ player }}
{% endfor %}
          message: "The washer has finished. Time to move the laundry to the dryer."
{% endif %}