Unfolded Circle for Home Assistant (Marketplace integration)

Installs: 610 sharing analytics
GitHub stars: 115
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v2.2.0, October 15, 2026
Category: Media and entertainment
Kind: Marketplace integration
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: unfoldedcircle
Source: github.com/JackJPowell/hass-unfoldedcircle
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

Screenshots From the README of JackJPowell/hass-unfoldedcircle.

About

Unfolded Circle is an integration that connects Home Assistant to Unfolded Circle Remote Two and Remote 3 remotes and their docks. It communicates locally and is found automatically on the network, then added through a guided setup in the UI that asks for the remote's PIN. It adds entities for activities, activity groups and media players, which can be created globally, per group or per activity, plus a light for the button backlight and a switch for wireless charging on Remote 3. Docks appear as sub-entries with infrared sending, LED brightness, reboot, identity flash and firmware update entities. Services send mapped button commands with repeats, delays and holds, and send or learn infrared codes. Options also let selected Home Assistant entities be shared back to the remote, and the remote's firmware can be updated from Home Assistant.

Automatic summary of the README and code of JackJPowell/hass-unfoldedcircle. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Lights
Media
Remotes
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Connect

Host
PIN Code
Home Assistant Websocket URL
Create activities as Switch entities
Use direct dock communication

Unfolded Circle Remote

PIN Code
Home Assistant Websocket URL
Create activities as Switch entities
Use direct dock communication

Configure Entities

Entities to share with Remote
Entities to remove from Remote
Automatically configure entities shared with Remote

Reauthenticate with PIN

PIN Code
Home Assistant Websocket URL

Update Remote Host

Host

Update WebSocket URL

WebSocket URL

After setup

Create a global media player entity for all activities
Create additional media player entities for each activity group
Create additional media player entities for each activity
Create all activities as switch entities
Suppress creation of activity group entities
Automatically sync activity states to other remotes
Activity to start when remote entity is toggled on
Use direct dock communication
Host / IP Address
Home Assistant Websocket Address
Home Assistant Websocket Address
Entities to share with Remote
Entities to remove from Remote
Automatically configure entities shared with Remote

Texts from the code of JackJPowell/hass-unfoldedcircle.

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Home Assistant integration for the Unfolded Circle Remote Two / Remote 3 and associated docks. A rich integration providing activity control, remote settings and diagnostics, firmware management, IR transmission & learning, wake features, dock management, wireless charging control and advanced automation hooks.
Automatic device & dock discovery (zeroconf)
Guided configuration flow and options flow
Flexible entity exposure: activities, groups, media players (global / per group / per activity)
Firmware update control with progress reporting
External Entity Management (select which HA entities are exposed back to the remote)
IR send (codeset/custom) with dock & port targeting
IR learning workflow that builds ready-to-use codesets
Mapped button command dispatch (long press, repeats, delays, activity scoping)
Activity maintenance services (e.g., prevent sleep toggling, standby inhibitors)
Wake on LAN for Remote Two (Remote 3 when firmware supports it)
Resource usage sensors (opt-in polling)
Docks as sub-entries: IR, brightness, identity, reboot, firmware