Support
Two Settings appear on this page: HA2ATV’s Settings, inside the app, and the Apple TV’s own Settings app.
Set up HA2ATV
- Open HA2ATV on your Apple TV. It looks for Home Assistant on your network. If it doesn’t find it, select Type the address instead.
- A QR code appears on the TV. Scan it with your phone’s camera.
- On your phone, sign in to Home Assistant with an administrator account, and approve HA2ATV.
- Back on the TV, select the dashboard you want to see.
Get the closest match
HA2ATV renders your dashboard natively, so the result depends on what the dashboard uses. Sections views built from Home Assistant’s own cards, with a Heading card at the top of each section, come across almost exactly. Select on the Siri Remote runs a card’s tap_action; hold and double-tap actions don’t run.
To see which cards changed and why, open HA2ATV’s Settings › Dashboards › What didn’t come across. The dashboard guide covers views, cards, custom cards, images and themes in full.
If it doesn’t connect
| Problem | What to check |
|---|---|
| HA2ATV can’t find Home Assistant | The Apple TV and Home Assistant are on the same network. Local Network access is on: on the Apple TV, open Settings › Privacy & Security › Local Network. Or type the address yourself. |
| The address isn’t accepted | Use the IP address and port, for example 192.168.1.20:8123 (in Home Assistant: Settings › System › Network). mDNS names such as homeassistant.local often fail to resolve on tvOS, and App Transport Security blocks plain http to other hostnames, so a name such as ha.lan needs https with a trusted certificate. |
| The sign-in page doesn’t open on your phone | Your phone must be on the same network as your Apple TV, because the page is served by your Apple TV. Mobile data, a guest network or a VPN can’t reach it. Home Assistant itself can be on that network or at a remote https URL. |
| The page says the code has been used | Go back to the connect screen on the TV for a new code. |
| Your phone says you’re signed in, but the TV doesn’t continue | On the TV, select Try again, and scan the new code. |
| “This account can’t list dashboards.” | Sign in again with an administrator account. |
Trial and purchase
Everything in HA2ATV is free for 1 day, starting the first time it connects to Home Assistant. After that, HA2ATV is a one-time purchase, with no subscription; the price is on the App Store and on the Unlock button. Until you buy it, a thank-you screen with an Unlock button takes the place of your dashboard.
- Buy: select Unlock HA2ATV on that screen, or open HA2ATV’s Settings › Purchase.
- Restore: if you bought it before with the same Apple Account, select Restore purchase.
- App Store unavailable: check that the Apple TV is online, then select Try again.
The sample home is free and isn’t part of the trial.
Sign in again or disconnect
In HA2ATV, open Settings › Home Assistant.
- Sign in again ends HA2ATV’s sign-in and starts a new one on your phone. Your chosen dashboard and every dashboard’s appearance are kept.
- Disconnect removes the token, your chosen dashboard and its cached images from the Apple TV. Every dashboard’s appearance is kept, and you can connect again at any time.
Both revoke HA2ATV’s refresh token in Home Assistant. You can also delete it yourself under Security in your Home Assistant profile.
Contact
Write to info@nomi-digital.com.au with your Apple TV model and Home Assistant version.