postlund / pyatv

A client library for Apple TV and AirPlay devices
https://pyatv.dev
MIT License
875 stars 95 forks source link

Is the Home Assistant AppleTV Integration Documentation Outdated #1920

Open The00Dustin opened 1 year ago

The00Dustin commented 1 year ago

What do you need help with?

When I first tried this integration a few months ago, I noticed this in the FAQ:

My Apple TV does not turn on/off when I press on/off in the frontend

That is correct; it only toggles the power state in Home Assistant. See the example above to use the home_hold command. This can be used on Apple TVs running tvOS 14.0 or later.

Later, I noticed that the On/Off button on the frontend DOES turn my Apple TV (4K) off, but not on. I tried to create an automation to turn on the Apple TV using Wake-On-LAN (and I am running my Apple TV wired), but that doesn't seem to work. I have resorted to disabling sleep and avoiding the power button in the card, but I would like to re-enable sleep and be able to wake the Apple TV with Home Assistant.

This has been on my list to try to ask about for a while, and I finally found the beta integration repo which links here for issues and appears to indicate that the latest Home Assistant version is now running the latest Apple TV integration version. I looked at the documentation linked here and see that the Power management section indicates it should be possible to turn on the Apple TV using atvremote (which uses the MAC address in the example, but as previously mentioned, I can't turn wake my Apple TV via Wake-On-LAN). Given that information, I am curious as to whether or not the Home Assistant documentation is out of date and also whether or not I should be able to wake my Apple TV using the integration.

As an aside, instead of spamming with additional issues, I would also like to know if I should always post technical (read: detailed undocumented behavior) Home Assistant Apple TV Integration questions here instead of in the forum. For instance, perhaps this integration question should have been posted here instead of there?

The00Dustin commented 1 year ago

I forgot to mention I also tried using the remote send command wakeup in attempts to turn on he Apple TV and these also didn't work. This begs the question: what is that remote command for?

ETA: Also tried the "turn on device" though I didn't expect that one to work with the FAQ entry I'm asking about here being given.

postlund commented 1 year ago

All I can say: the documentation is (likely) very out-of-date and could care for some love. I would appreciate PRs with open arms!