Unfolded Circle
JackJPowell/hass-unfoldedcircle · vv2.2.0
Home Assistant Integration for the Unfolded Circle line of remotes
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
media_player | TV, receiver or media switches | Needs its own HomeKit Bridge in accessory mode |
remote | TV remote (activities) | Needs its own HomeKit Bridge in accessory mode |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
1 report below say how a device from this integration behaves in the Home app.
What people report
Unfolded Circle Remote Two/3 and Dock work locally; users bridge the remote entity to HomeKit as a TV with activities as inputs.
- Works2
- Partly works2
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Unfolded Circle Dock | Works | Initial dock firmware update and mapped button commands addedSaved copyzeroconf 2025.2 send mapped buttons commands Initial dock update support (only notification and install) Fix bug where partial firmware progress was being reported Excerpt saved from GitHub on 2026-10-23. | PR #90 · 2025-02 | |
| Unfolded Circle Remote Two / Remote 3 | Works Local | Listed in README; activities, firmware, WoL, button backlight supportedSaved copySupported devices: Component; Remote Two / Remote 3; Dock; Activity / Activity Group; Firmware; IR Dataset; IR Emitter; Button Backlight; Wireless Charging. Excerpt saved from the README on 2026-10-23. | README | |
| Unfolded Circle Remote 2 Wake-on-LAN | Partly works Local | WoL switch off fixed in v0.13.1; firmware bug drops wifi after disabling WOLSaved copyDescribe the bug Wake-on-LAN deactivation in Home Assistant fails. To Reproduce Steps to reproduce the behavior: 1. Enable Wake-on-LAN on the Remote 2. Disable the switch Wake-on-LAN in Home Assistant 3. An error occurs Expected behavior Wake-on-LAN is deactivated on the Remote Screenshots Additional context Logs: `Traceback (most recent call last): File "/usr/src/homeassistant/homeassistant/components/websocket_api/commands.py", line 245, in handle_call_service response = await hass.services.async_call( ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ File "/usr/src/homeassistant/homeassistant/core.py", line … Excerpt saved from GitHub on 2026-10-23. | Issue #60 · 2024-11 | |
| Unfolded Circle Remote 3 via HomeKit Bridge | Partly works | Partly in Home Shows as TV with activities as source inputs; cannot start an activity | Remote entity can switch or stop activities but cannot start oneSaved copyI've been testing with how best to pass my remote 3 into HomeKit so I can use Siri to start/stop activities. The easiest way to do this is by using HomeKit bridge (in accessory mode) to pass in the remote entity (`remote.remote_3_remote`). This then exposes itself as a TV in HomeKit with each activity exposed as a 'source input': If an activity is already running, I can then used this `TV` in HomeKit to change activities and turn off activities. The trouble is, this entity can't be used to start an activity. I realise there are other options by exposing switches etc, but none are as clean … Excerpt saved from GitHub on 2026-10-23. | Discussion #112 · 2025-08 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local push
Talks to the device on your network, and the device tells Home Assistant the moment something changes.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 614 (0.09%) |
|---|---|
| GitHub stars | 115 |
| Latest version | v2.2.0 (2026-10-15) |
| Set up in the UI | Yes |
| Maintainers | @jackjpowell |
| License | MIT |
Devices listed in its README
- Component
- Remote Two / Remote 3
- Dock
- Activity / Activity Group
- Firmware
- IR Dataset
- IR Emitter
- Button Backlight
- Wireless Charging
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
