Apple TV App for Home Assistant - HA Control

Hey, sorry for the late message. The issue with grouping devices via the Home Assistant UI is that it only allows you to group devices of the same type. However, in YAML, you can group any devices you want and then pass that group to the Apple TV.

Has it started working in the meantime, or can I still help you with anything?

Thank you for your support, I also had the idea to start some development with Xcode (my license is still valid).
I noticed the difference between definition of groups in yams and via the UI.
But my assumption was that the group name is used by your app. So I tried different names (via the UI), but this doesnā€˜t works.

Hi, sorry for the late message. I was busy fixing some issues, but the newly revised version is now ready. It’s now available via TestFlight. If you’re not in the beta yet, I’d be happy to add you—just send me the email address linked to your Apple ID.

Regarding your issue: what groups do you have, or what does your Home Assistant configuration look like?

Hi,
you can use [email protected]

In the configuration.yaml I tried one Shelly device, but it doesnā€˜t showed up in HA Control:

group:
hatv_control_scene:
name: HATV Control Scenes
entities:
hatv_control_devices:
name: HATV Control Devices
entities:
- light.shelly1minig3_5432044da2e0_switch_0
hatv_control_sensors:
name: HATV Control Sensors
entities:

You must make sure the YAML is correctly formatted — indentation and structure are essential.

group:
  hatv_control_scene:
    name: HATV Control Scenes
    entities: []
  hatv_control_devices:
    name: HATV Control Devices
    entities:
      - light.shelly1minig3_5432044da2e0_switch_0
  hatv_control_sensors:
    name: HATV Control Sensors
    entities: []

Once that’s done, and restarted the server, check if the groups appear in your Home Assistant dashboard. You can also press the ā€œeā€ key on your keyboard to bring up the entity search, then type the name of your group. If everything is set up properly, your group and its included entities should be listed there.

Hi there, love the app so far, pretty cool being able to see my Home Assistant devices and sensors.

One thing to note, I notice I can’t get my camera feeds from my Reolink NVR integration onto the app. Would love to have these viewable from my Apple TV via Home Assistant. Any idea if the current app is capable of this?

Not at the moment. I intentionally left it out because I prefer the HomeKit integration, which I find more powerful and flexible. It also supports features like Picture-in-Picture, which, as far as I know, is not allowed for apps like mine.

However, I’m happy to look into it and consider supporting it in a future version.

HA Control for Apple TV - New Version Available!

I’m excited to announce the latest version of HA Control for Apple TV! This version brings numerous improvements and new features that make controlling your smart home from your couch even easier and more intuitive.

Key New Features

1. Completely Reworked Connection System

The connection system has been rebuilt from the ground up to now fully utilize WebSocket, providing significantly faster and smoother performance. Response times are now noticeably shorter, and the stability of the connection to your Home Assistant has been greatly improved. This WebSocket-based approach ensures real-time updates and more efficient communication with your Home Assistant instance.

2. New Tile Mode

The new tile mode offers a grid-based interface specifically optimized for operation with the Apple TV remote.

The app now includes enhanced views for different entity types eg:

Sensor History View

Door Lock/Unlock

Alarm Control Panel

The alarm control panel interface has been redesigned for easier operation with the Apple TV remote, providing quick access to arm, disarm, and other security functions.

3. Support for Custom Group Naming

You can now use custom names for your groups. This feature allows you to organize your smart home devices more flexibly and customize them exactly to your needs.

Tip: While dynamic groups have been supported for some time, you can automate your groups in Home Assistant to make your app experience even more dynamic. Create groups that change based on time of day, presence, or other conditions.

4. Custom Icons for Devices and Entities

Personalize your interface with custom icons for your devices and entities. Choose from a variety of icons or use SF Symbols to make your smart home control even more intuitive.

Configuration Example

group:
  hacontrol_01:
    name: Living Room
    icon: sf:sofa.fill
    entities:
      - light.living_room_ceiling
      - light.living_room_floor_lamp
      - switch.tv_power
      - media_player.living_room_tv
      - cover.living_room_blinds
      - climate.living_room_thermostat

  hacontrol_02:
    name: Kitchen & Dining
    icon: sf:fork.knife
    entities:
      - light.kitchen_main
      - light.dining_table
      - switch.coffee_machine
      - fan.kitchen_hood
      - sensor.kitchen_temperature
      - binary_sensor.kitchen_door

  hacontrol_03:
    name: Scenes & Automations
    icon: sf:wand.and.stars
    entities:
      - scene.movie_night
      - scene.dinner_time
      - scene.good_morning
      - scene.good_night
      - input_boolean.vacation_mode
      - automation.turn_off_lights

Roadmap

I’m continuously working to improve HA Control. Here’s what’s coming in future updates:

  • Enhanced Light Controls: Better dimming, color selection, and more advanced lighting options
  • Direct Select Support: Ability to directly select options from dropdown menus
  • Design Improvements: Ongoing UI refinements for an even better user experience

Availability

The new version is available now on the App Store. Existing users will receive the update automatically.

Download on the App Store

Feedback and Support

I welcome your feedback on the new version! For questions or issues, please leave a comment in this thread or write me a PM.


Note: For complete documentation, please visit my official website.

I’m getting an error on the Apple TV while trying to setup. I’ve pasted into the connection the long lived token. When I connect, Apple TV throws this error:

Error

The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.

Do I need to configure TLS on Home Assistant?

Hi,

No certificate is required. What does your setup look like?

What URL are you using? There might be a typo, or you may have used https instead of http by mistake.

Make sure to specify the protocol explicitly — for example:
http://192.168.1.10:8123

I changed it from an internal DNS hostname to an IP address and then it worked.

1 Like

Just tried setting up the app. Everything seems fine but I’ve noticed that if I switch back to the app when it’s in the background it gives an error:

ā€œThe operation couldn’t be completed. Software caused a connection abortā€.

If I kill the app and restart, or if I reconnect in the settings it sorts itself.

One minor cosmetic thing is that the screen momentarily shows ā€œno entities foundā€ before displaying the list of entities.

Hope this information is some help.

BTW, is adding support for cover tilting e.g. SET_COVER_TILT_POSITION a possibility or beyond the scope of where you plan to go?

Thanks for developing this app…

1 Like

Impossible to enter the URL of my home assistant… I’ve tried 10 times !

There appears to be a bug in the input field validation which prevents the removal of the ā€œhttp://ā€ prefix in order to replace it with ā€œhttps://ā€ when attempting to enter the HA URL, the app just blanks the field and won’t let you edit it.

Could this be addressed please? A lot of us are using SSL to secure our HA instances.

Thanks

Could you share more details about your setup? Are you using a custom SSL certificate?

In my case, it works over HTTPS using either NabuCasa or Cloudflared.

I’m currently working on more detailed error handling and better support. I suspect the issue is that your SSL certificate isn’t being trusted, which is likely causing the error.

Great idea — I’ll definitely add it to the to-do list. I still need to come up with a smart UI for options like that.

Could you share more details, like what the URL looks like and what you’ve tried so far? Or maybe give me an overview of your setup — feel free to send it via DM if you prefer.

Hi! Cool app!

I do have 2 questions. How do i show friendly names. Right now it’s showing entity names.

And nr2: Once i exit the app, when i reopen i have to connect again.

Edit, found out how to name it. Add name at the entity config itself.
It does keep disconnecting however

Hi. For the life of me I can’t get the groups setup. I’ve tried adding them to configuration.yaml and creating groups.yaml (below). Any tips? I’m rather new to HA.
(edit: solved - must’ve been a syntax issue)

group:
  hacontrol_01:
    name: Lounge Lights
    icon: sf:sofa.fill
    entities:
      - script.lounge_lights_bright
      - script.lounge_lights_low
      - script.lounge_lights_tv
      - script.lounge_lights_off
  hacontrol_02:
    name: Lounge Lights 2
    icon: sf:sofa.fill
    entities:
      - light.loungelamp1_lounge_lamp
      - light.sunset_light
  hacontrol_03:
    icon: sf:sofa.fill
    name: Spare
    entities: []