Home Assistant Apple TV Automation: Movie Night Lighting

Nov. 17, 2026 Alex Carter
Movie Night lighting: dim for playback, brighter for pauses. Illustration.
Movie Night lighting: dim for playback, brighter for pauses. Illustration.

Home Assistant can dim your living-room lights when Apple TV starts playing and bring them up when you pause. The setup needs a working Apple TV media-player entity, two lighting scenes, and an automation that reacts to the playback states your streaming app actually reports.

Enable Movie Night before watching to let playback control the room. The YAML below is an illustrative configuration to adapt to your entities; it has not been tested on a household installation.

What runs the automation?

The official Apple TV integration connects the streaming device to Home Assistant and creates its media-player entity. Home Assistant watches that entity and activates your lighting scenes. It must remain running and able to communicate with Apple TV and the lights.

HADash provides an optional dashboard on Apple TV for supported controls. You can use it before watching to operate your household scenes, then switch to your streaming app. The lighting automation runs on the Home Assistant server while you watch; HADash does not need to remain open. See our Apple TV integration and HADash comparison for the separate roles.

1. Check playback states before building anything

If Apple TV is not yet connected, open Settings → Devices & services in Home Assistant, add the Apple TV integration, and complete its pairing instructions. Find the media_player entity created for your device.

Open Settings → Tools → States and locate that entity. Older Home Assistant versions may label this area Developer tools. Use an administrator account to access these tools. While someone starts, pauses, and resumes a video on Apple TV, observe its state. Use the app you intend to watch, then repeat the check in any other apps you use.

  • Playing: look for the stored state playing while the video runs.
  • Paused: look for paused after pressing pause.
  • Idle, off, unknown, or unavailable: record when these appear instead of treating them as pauses.

Home Assistant documents these values in its media-player state reference. A changed title or playback position is not the same as a changed playback state.

Application behavior can limit the result. The pyatv FAQ documents missing metadata, previews that produce playback updates, and app-specific state reporting problems. If the entity never distinguishes playing from paused in your chosen app, use manual scene controls for that app; the automation below cannot infer a pause that Home Assistant never receives.

2. Create Movie Playing and Movie Pause scenes

In Settings → Automations & scenes → Scenes, create two scenes using only the lighting entities you want this routine to control. Set their desired states, save them, and apply each scene manually to confirm the result.

  • Movie Playing: for example, set a dimmable lamp to 15% and keep the TV backlight on.
  • Movie Pause: for example, raise that lamp to 45% while keeping the same backlight.

These brightness levels are starting points, not required values. Choose settings that work for the room and supported light hardware. Leave unrelated lights out of both scenes.

Check the actual entity IDs after saving. This guide uses scene.movie_playing and scene.movie_pause as examples; your installation may assign different IDs.

A Home Assistant scene applies stored device states once. It does not remain on or remember the previous lighting automatically. The pause scene therefore provides a chosen brightness preset, rather than restoring whatever the lights were doing before the film.

3. Add a Movie Night switch

Create a Toggle helper under Settings → Devices & services → Helpers. Name it Movie Night and check its entity ID. The example below uses input_boolean.movie_night.

Keep the helper off during ordinary Apple TV browsing. Turn it on when you want playback changes to control the lights, and off when the viewing session ends.

This switch gives the automation an explicit condition: it may change the lighting only during an enabled Movie Night session. It does not identify films, block previews inside that session, or change the lights simply because you turn it on.

4. Add the playback automation

Create a new automation in Settings → Automations & scenes. Open its menu, choose Edit in YAML, and use the following as the complete automation body. Replace both occurrences of the Apple TV entity ID, the helper ID, and both scene IDs with the ones you verified.

This is an automation-editor example, without an outer automation: key. If you maintain automations.yaml directly, add it as a list item using the format of that file.

alias: "Apple TV - Movie Night lighting"
description: "Apply lighting presets during an enabled Movie Night session."
triggers:
  - trigger: state
    entity_id: media_player.living_room_apple_tv
    not_from:
      - "unknown"
      - "unavailable"
    to: "playing"
    for: "00:00:03"
    id: "playing"
  - trigger: state
    entity_id: media_player.living_room_apple_tv
    not_from:
      - "unknown"
      - "unavailable"
    to: "paused"
    for: "00:00:03"
    id: "paused"
conditions:
  - condition: state
    entity_id: input_boolean.movie_night
    state: "on"
actions:
  - choose:
      - conditions:
          - condition: trigger
            id: "playing"
        sequence:
          - action: scene.turn_on
            target:
              entity_id: scene.movie_playing
      - conditions:
          - condition: trigger
            id: "paused"
        sequence:
          - action: scene.turn_on
            target:
              entity_id: scene.movie_pause
mode: restart

The state triggers require the new state to persist for three seconds. A shorter pause will not raise the lights. Excluding unknown and unavailable as starting states also avoids acting on a direct recovery from either state to playing or paused.

Both triggers specify a destination state, so metadata-only changes do not repeatedly activate the scene. Each trigger has an ID, and the matching branch applies its scene after the Movie Night condition passes.

The restart mode stops a previous action sequence when a new qualifying run starts. It does not undo a scene already applied. The three-second filter comes from for, and pending for timers reset when Home Assistant restarts or automations reload.

5. Test the whole sequence

  1. Save and enable the automation. With Movie Night off, start and pause a video. The automation should leave the lights unchanged.
  2. Turn Movie Night on before starting playback. Play for more than three seconds and confirm that Movie Playing is applied.
  3. Pause for more than three seconds and confirm that Movie Pause is applied.
  4. Resume for more than three seconds and confirm that the dim scene returns.
  5. Turn Movie Night off. Pause and resume again to check that further playback changes leave the lights alone.

Test real playback transitions rather than relying only on the automation editor's Run actions command. This example chooses a branch by trigger ID, which a manual action run does not reproduce. Inspect the automation's traces and troubleshooting information to see which trigger fired, whether the condition passed, and which action ran.

Enabling the helper halfway through an unchanged playing state does not fire either trigger. Pause and resume, or apply Movie Playing manually. Disabling Movie Night also leaves the current lighting in place; choose your normal lighting scene when you finish.

Keep previews and short interruptions under control

The three-second duration filters brief state changes. It cannot distinguish a long preview from a film if both report playing. Enable Movie Night only when you are ready to watch, and check how browsing, seeking, episode transitions, and app switching affect the entity.

For an evening-only setup, add a time or sun condition to the playing branch before its scene action. Keep the pause branch available while Movie Night is enabled, so crossing a time boundary does not prevent pause lighting. Choose the time window for your household; the base example has no time restriction.

The example leaves idle and off without lighting actions. The pyatv known-issues list describes idle reports during some intros and next-episode screens. Add an end-of-session rule only after observing your own app’s behavior.

Use HADash for manual scene controls

On your Home Assistant TV dashboard, add supported controls for Movie Playing, Movie Pause, and your normal room lighting scene. Our guide to lights and scenes on Apple TV covers the dashboard setup.

The HADash card support list includes Button cards. Configure the intended scene action in Home Assistant and test that specific control with the Siri Remote in your installed HADash version. Add a clearly labeled Movie Night helper control if its interaction works in your dashboard; otherwise operate the helper from Home Assistant on your phone.

A manual scene action works independently of the playback trigger, so it remains useful when a streaming app reports states inconsistently. To make a lasting manual lighting change during a session, turn Movie Night off first; otherwise the next qualifying playback transition may apply an automatic scene again.

If the lights do not behave as expected

No response when a video starts

Check the media-player entity's real state first. Then check that Movie Night is on, the automation is enabled, and the state remains playing for the full three seconds. A direct transition from unavailable or unknown is intentionally excluded. Test another pause-and-resume cycle after the device has recovered.

The automation runs, but the room stays dark

Apply Movie Pause directly in Home Assistant. If it fails there too, check the scene's included entities, their availability, and the saved brightness settings. If direct activation works, inspect the automation trace for the selected branch and target scene ID.

Lights rise during seeking or between episodes

Observe the states reported during that exact action. Increase the pause duration if the false paused state is brief. If it persists, use manual control for that app or disable Movie Night while browsing. Do not replace a missing paused report with a catch-all rule for every non-playing state.

Movie Night seems enabled after a restart

Check the helper's startup behavior. A Toggle helper restores its previous state by default. If you want each viewing session to require a fresh opt-in, select the helper's turn-off-on-start option where available, or configure a separate startup automation to turn it off.