Skip to content

Conversation

@mik-laj
Copy link
Contributor

@mik-laj mik-laj commented Nov 2, 2025

Added attributes and examples for timer integration.

Proposed change

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

  • Link to parent pull request in the codebase:
  • Link to parent pull request in the Brands repository:
  • This PR fixes or closes issue: fixes #

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

Added attributes and examples for timer integration.
Copilot AI review requested due to automatic review settings November 2, 2025 22:51
@home-assistant home-assistant bot added the current This PR goes into the current branch label Nov 2, 2025
@netlify
Copy link

netlify bot commented Nov 2, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 0bef3c6
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6907e6d8866eed000820ed64
😎 Deploy Preview https://deploy-preview-41580--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR enhances the timer integration documentation by adding comprehensive information about timer attributes, template examples, and a practical automation example. The additions help users understand how to work with timer entities more effectively, especially for creating dynamic countdowns and automated lighting scenarios.

  • Adds a new "Attributes" section documenting the key timer entity attributes (duration, remaining, finishes_at, restore)
  • Introduces a "Templates" section with two practical examples for displaying remaining time and end time
  • Adds a motion-activated light automation example demonstrating real-world timer usage

mik-laj and others added 8 commits November 2, 2025 23:53
Updated note formatting for clarity.
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
| `timer.restarted` | Fired when a timer has been restarted |
| `timer.paused` | Fired when a timer has been paused |

## Attributes
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Corrected the description of the 'editable' attribute for clarity.
When motion stops and the timer finishes, the light turns off.

```yaml
alias: Motion-Activated Hall Light
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here I specifically used trigger_id to have an example of how to handle two events in one automation, which is useful when you manages automations in the UI.

Copy link
Contributor

@c0ffeeca7 c0ffeeca7 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please fill out the PR template

@home-assistant home-assistant bot marked this pull request as draft November 4, 2025 05:52
@home-assistant
Copy link

home-assistant bot commented Nov 4, 2025

Please take a look at the requested changes, and use the Ready for review button when you are done, thanks 👍

Learn more about our pull request process.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

current This PR goes into the current branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants