Add Homecast integration documentation

Gemfile

@@ -8,7 +8,7 @@ group :development do
   gem 'stringex', '2.8.6'
   gem 'sass-embedded', '1.98.0'
   gem 'rubocop', '1.86.0'
-  gem 'ruby-lsp', '0.26.8'
+  gem 'ruby-lsp', '0.26.9'
   gem 'rackup', '2.3.1'
 end
 

Gemfile.lock

@@ -14,9 +14,9 @@ GEM
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0)
     eventmachine (1.2.7)
-    ffi (1.17.3-aarch64-linux-gnu)
-    ffi (1.17.3-arm64-darwin)
-    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
     forwardable-extended (2.6.0)
     google-protobuf (4.34.1-aarch64-linux-gnu)
       bigdecimal
@@ -61,7 +61,7 @@ GEM
       nokogiri (~> 1.12)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    json (2.19.2)
+    json (2.19.3)
     kramdown (2.5.2)
       rexml (>= 3.4.4)
     kramdown-parser-gfm (1.1.0)
@@ -108,7 +108,7 @@ GEM
     rb-fsevent (0.11.2)
     rb-inotify (0.11.1)
       ffi (~> 1.0)
-    rbs (4.0.1)
+    rbs (4.0.2)
       logger
       prism (>= 1.6.0)
       tsort
@@ -129,7 +129,7 @@ GEM
     rubocop-ast (1.49.1)
       parser (>= 3.3.7.2)
       prism (~> 1.7)
-    ruby-lsp (0.26.8)
+    ruby-lsp (0.26.9)
       language_server-protocol (~> 3.17.0)
       prism (>= 1.2, < 2.0)
       rbs (>= 3, < 5)
@@ -178,7 +178,7 @@ DEPENDENCIES
   rackup (= 2.3.1)
   rake (= 13.3.1)
   rubocop (= 1.86.0)
-  ruby-lsp (= 0.26.8)
+  ruby-lsp (= 0.26.9)
   sass-embedded (= 1.98.0)
   sinatra (= 4.2.1)
   stringex (= 2.8.6)

source/_data/people.yml

@@ -38,6 +38,10 @@ Stefan Agner:
   name: Stefan Agner
   github: agners
 
+Erik Montnémery:
+  name: Erik Montnémery
+  github: emontnemery
+
 Bruno Pantaleão:
   name: Bruno Pantaleão
   github: bgoncal

source/_includes/post/author.html

@@ -6,12 +6,19 @@
   {% assign author = site.author %}
 {% endif %}
 {% if author %}
-  {% assign person = site.data.people[author] %}
-  {% if person %}
-    <span class="byline author vcard">
-      <a href="https://github.com/{{ person.github }}" target="_blank"><img class="author-avatar" src="https://avatars.githubusercontent.com/{{ person.github }}?size=64" alt="{{ person.name }}"/>{{ person.name }}</a>
-    </span>
+  {% if author.first %}
+    {% assign authors = author %}
   {% else %}
-    <span class="byline author vcard">{% icon "mdi:person" %} {{ author }}</span>
+    {% assign authors = author | split: "<<<NOSPLIT>>>" %}
   {% endif %}
+  {% for a in authors %}
+    {% assign person = site.data.people[a] %}
+    {% if person %}
+      <span class="byline author vcard">
+        <a href="https://github.com/{{ person.github }}" target="_blank"><img class="author-avatar" src="https://avatars.githubusercontent.com/{{ person.github }}?size=64" alt="{{ person.name }}"/>{{ person.name }}</a>
+      </span>
+    {% else %}
+      <span class="byline author vcard">{% icon "mdi:person" %} {{ a }}</span>
+    {% endif %}
+  {% endfor %}
 {% endif %}

source/_includes/site/head.html

@@ -7,7 +7,7 @@
     <meta charset="utf-8">
     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
     <title>{% if page.title %}{{ page.title }} - {% endif %}{{ site.title }}</title>
-    <meta name="author" content="{% if page.author %}{{ page.author }}{% else %}{{ site.author }}{% endif %}">
+    <meta name="author" content="{% if page.author %}{% if page.author.first %}{{ page.author | join: ", " }}{% else %}{{ page.author }}{% endif %}{% else %}{{ site.author }}{% endif %}">
     <meta name="description" content="{{ page.description | default: site.description | strip_html | truncate: 160 }}">
     {% if page.keywords %}<meta name="keywords" content="{{ page.keywords }}">{% endif %}
     <meta name="viewport" content="width=device-width">

source/_includes/site/social_meta.html

@@ -44,7 +44,7 @@
 <meta name="twitter:label1" value="Reading time">
 <meta name="twitter:data1" value="~{{ reading_time }} minute{% if reading_time > 1 %}s{% endif %}">
 <meta name="twitter:label2" value="Written by">
-<meta name="twitter:data2" value="{{ page.author | default: site.author | escape_once }}">
+<meta name="twitter:data2" value="{% if page.author.first %}{{ page.author | join: ", " | escape_once }}{% else %}{{ page.author | default: site.author | escape_once }}{% endif %}">
 {% endif %}
 
 {% if site.social.mastodon.account %}<link rel="me" href="{{ site.social.mastodon.account | escape_once }}">{% endif %}

source/_integrations/broadlink.markdown

@@ -73,7 +73,7 @@ The `remote` {% term entities %} allow you to learn and send codes with universa
 
 ### Learning commands
 
-Use `remote.learn_command` to learn IR and RF codes. These codes are grouped by device and stored as commands in the [storage folder](#learned-codes-storage-location). They can be sent with the `remote.send_command` action later.
+Use `remote.learn_command` to learn IR and RF codes. These codes are grouped by device and stored as commands in the [storage folder](#learned-codes-storage-location). They can be sent with the `remote.send_command` action later. A convenient interface to learn, send, and delete codes can be found in web interface under  `/developer-tools/service`.
 
 | Data attribute | Optional | Description                           |
 | ---------------------- | -------- | ------------------------------------- |
@@ -428,6 +428,7 @@ The above example creates `switch.philips_tv` and `switch.lg_tv`, which are rela
 
 __IMPORTANT__: Always use unique names for your switches. A good choice is to prefix the name with the area in which the device is located, e.g. Bedroom TV.
 
+##  Managing codes for remotes
 ### Using e-Control remotes
 
 If you already have your remotes learned on e-Control app you can use this method to "copy" them to Home Assistant.
@@ -698,3 +699,7 @@ Assuming that your (or similar) device is in one of these databases:
 - <https://github.com/probonopd/irdb/tree/master/>
 
 You can grab `irdb2broadlinkha.sh` from [irdb2broadlinkha](https://github.com/molexx/irdb2broadlinkha) project and try to convert codes to format suitable for Home Assistant.
+
+### Managig codes with Broadlink Manager
+
+A Docker based GUI to learn, send, and generate IR and RF codes is available through the [Broadlink Manager project](https://github.com/t0mer/broadlinkmanager-docker)

source/_integrations/homecast.markdown

@@ -0,0 +1,104 @@
+---
+title: Homecast
+description: Instructions on setting up Homecast within Home Assistant.
+ha_category:
+  - Alarm
+  - Binary sensor
+  - Climate
+  - Cover
+  - Fan
+  - Hub
+  - Light
+  - Lock
+  - Sensor
+  - Switch
+ha_release: "2025.12"
+ha_iot_class: Cloud Polling
+ha_config_flow: true
+ha_domain: homecast
+ha_platforms:
+  - alarm_control_panel
+  - binary_sensor
+  - climate
+  - cover
+  - fan
+  - light
+  - lock
+  - sensor
+  - switch
+ha_integration_type: hub
+ha_codeowners:
+  - '@parob'
+ha_quality_scale: bronze
+---
+
+[Homecast](https://homecast.cloud) bridges Apple HomeKit smart home devices to open standards, enabling remote control, API access, and AI assistant integration. The Homecast Mac or iOS app runs on your home network as a relay between HomeKit and the Homecast cloud.
+
+This integration connects Home Assistant to the Homecast cloud API, exposing your HomeKit devices as native Home Assistant entities.
+
+{% include integrations/config_flow.md %}
+
+## Prerequisites
+
+- A [Homecast](https://homecast.cloud) account
+- The Homecast Mac or iOS app running on your home network as a relay
+- At least one HomeKit home with devices
+
+## Setup
+
+1. Go to **{% my integrations title="Settings > Devices & services" %}** and click **Add integration**.
+2. Search for **Homecast** and select it.
+3. You will be redirected to the Homecast OAuth consent screen.
+4. Log in with your Homecast account.
+5. Select which homes to share and the permission level (view or control).
+6. Confirm — your HomeKit devices will appear in Home Assistant within seconds.
+
+No manual OAuth client registration is needed — the integration handles this automatically using PKCE.
+
+## Supported devices
+
+| HomeKit device | Home Assistant platform | What you can control |
+| --- | --- | --- |
+| Lightbulb | Light | On/off, brightness, color, color temperature |
+| Switch / Outlet | Switch | On/off |
+| Thermostat / Heater-Cooler | Climate | HVAC mode, temperature targets |
+| Lock | Lock | Lock / unlock |
+| Window Covering | Cover | Position (0–100%), open/close |
+| Fan | Fan | On/off, speed |
+| Security System | Alarm control panel | Arm home/away/night, disarm |
+| Motion Sensor | Binary sensor | Motion detected |
+| Contact Sensor | Binary sensor | Open/closed |
+| Temperature Sensor | Sensor | Temperature (°C) |
+| Light Sensor | Sensor | Illuminance (lux) |
+
+Devices with batteries automatically get battery level and low battery entities.
+
+## How it works
+
+The integration polls the Homecast REST API (`GET /rest/state`) every 30 seconds to fetch device state. When you control a device through Home Assistant, it sends the command via `POST /rest/state` and triggers an immediate refresh.
+
+Devices are automatically organized into Home Assistant areas based on their HomeKit room names. If you have multiple homes, room names are prefixed with the home name (for example, "County Hall - Living Room").
+
+## Data updates
+
+The integration polls the Homecast cloud API every 30 seconds. After sending a control command, an additional refresh is triggered for faster feedback.
+
+## Removing the integration
+
+This integration follows standard integration removal. No extra steps are required.
+
+{% include integrations/remove_device_service.md %}
+
+## Troubleshooting
+
+### Devices not appearing
+
+Make sure the Homecast relay app (Mac or iOS) is running and connected. The relay must be online for the API to return device state.
+
+### Stale or delayed state
+
+State updates every 30 seconds via polling. WebSocket-based real-time updates are planned for a future release.
+
+### Re-authentication
+
+If your OAuth token expires, Home Assistant will show a notification prompting you to re-authenticate. Go to **{% my integrations title="Settings > Devices & services" %}** > **Homecast** and follow the re-auth flow.

source/_posts/2015-12-13-setup-encryption-using-lets-encrypt.markdown

@@ -3,7 +3,9 @@ title: "Set up encryption using Let's Encrypt"
 description: "Tutorial how to encrypt your connection with Home Assistant."
 date: 2015-12-13 10:05:00 -0800
 date_formatted: "December 13, 2015"
-author: Paulus Schoutsen & Martin Hjelmare
+author:
+  - Paulus Schoutsen
+  - Martin Hjelmare
 author_twitter: balloob
 categories: How-To
 og_image: /images/blog/2015-12-lets-encrypt/letsencrypt-secured-fb.png

source/_posts/2016-02-09-Smarter-Smart-Things-with-MQTT-and-Home-Assistant.markdown

@@ -3,7 +3,9 @@ title: "Smarter SmartThings with MQTT and Home Assistant"
 description: "Jer and St. John describe how they connected SmartThings with Home Assistant."
 date: 2016-02-09 0:44 -0700
 date_formatted: "February 09, 2016"
-author: Jeremiah Wuenschel and St. John Johnson
+author:
+  - Jeremiah Wuenschel
+  - St. John Johnson
 categories: How-To MQTT
 og_image: /images/blog/2016-02-smartthings/social.png
 ---

source/_posts/2016-07-30-custom-frontend-panels--jupyter-notebooks--directv.markdown

@@ -3,7 +3,9 @@ title: "0.25: Custom frontend panels, Jupyter notebooks, DirecTV."
 description: "Frontend became blazing fast and extensible. DirecTV support added."
 date: 2016-07-30 12:00:00 +0000
 date_formatted: "July 30, 2016"
-author: Fabian Affolter & Paulus Schoutsen
+author:
+  - Fabian Affolter
+  - Paulus Schoutsen
 author_twitter: fabaff
 categories:
 - Release-Notes

source/_posts/2016-09-29-async-sleepiq-emoncms-stocks.markdown

@@ -3,7 +3,9 @@ title: "0.29: 🎈 Async, SleepIQ, OpenALPR, EmonCMS, stocks, and plants"
 description: "Move to asynchronous, Support for SleepIQ, OpenALPR, and EmonCMS, and other goodies."
 date: 2016-09-29 03:04:05 +0000
 date_formatted: "September 29, 2016"
-author: Paulus Schoutsen & Fabian Affolter
+author:
+  - Paulus Schoutsen
+  - Fabian Affolter
 author_twitter: balloob
 categories:
 - Release-Notes

source/_posts/2017-02-11-alert-appletv-mqtt-yeelight.markdown

@@ -3,7 +3,9 @@ title: "0.38: Alert, AppleTV, MQTT discovery, and Yeelight"
 description: "Faster and more configurable frontend, configuration check, and complete move to async for core"
 date: 2017-02-11 08:04:05 +0000
 date_formatted: "February 11, 2017"
-author: Robbie Trencheny, Fabian Affolter
+author:
+  - Robbie Trencheny
+  - Fabian Affolter
 author_twitter: robbie
 categories:
 - Release-Notes

source/_posts/2017-05-20-automation-editor-zwave-panel-ocr.markdown

@@ -3,7 +3,9 @@ title: "Home Assistant 0.45: Automation editor, Z-Wave panel, OCR"
 description: "AXIS and Keene support, PiFace, Raspihats, and Datadog integration"
 date: 2017-05-20 13:00:00 +0000
 date_formatted: "May 20, 2017"
-author: Paulus Schoutsen & Fabian Affolter
+author:
+  - Paulus Schoutsen
+  - Fabian Affolter
 author_twitter: balloob
 categories:
 - Release-Notes

source/_posts/2017-06-20-things-you-should-know-about-senic-covi.markdown

@@ -3,7 +3,9 @@ title: "[Update: fixed] A frank and serious warning about X"
 description: "The picture painted is not as great as it seems."
 date: 2017-06-20 01:04:05 +0000
 date_formatted: "June 20, 2017"
-author: Paulus Schoutsen & Robbie Trencheny
+author:
+  - Paulus Schoutsen
+  - Robbie Trencheny
 author_twitter: balloob
 categories: Public-Service-Announcement
 ---

source/_posts/2017-11-12-tor.markdown

@@ -3,7 +3,9 @@ title: "Secure remote access to Home Assistant using Tor"
 description: "Using Tor with Home Assistant and Hass.io."
 date: 2017-11-12 10:00:00 +0200
 date_formatted: "November 12, 2017"
-author: Franck Nijhof & Fabian Affolter
+author:
+  - Franck Nijhof
+  - Fabian Affolter
 author_twitter: frenck
 categories: How-To
 og_image: /images/blog/2017-11-tor/social.png

source/_posts/2020-08-05-mobile-apps-new-features.markdown

@@ -4,7 +4,9 @@ description: "What's new and what's in the works with the companion apps"
 date: 2020-08-05 00:00:00
 date_formatted: "August 5, 2020"
 comments: true
-author: Daniel Shokouhi & Tom Brien
+author:
+  - Daniel Shokouhi
+  - Tom Brien
 author_twitter: tbrien88
 categories: Release-Notes
 og_image: /images/blog/2020-08-05-mobile-apps-new-features/Companion-new-upcoming.png

source/_posts/2023-10-19-security-audits-of-home-assistant.markdown

@@ -4,7 +4,9 @@ title: "Security audits of Home Assistant"
 description: "Home Assistant hired Cure53 to do a security audit as part of our regular security assessments. You are safe. No authentication bypasses have been found."
 date: 2023-10-19 00:00:00
 date_formatted: "October 19, 2023"
-author: Paulus Schoutsen & Franck Nijhof
+author:
+  - Paulus Schoutsen
+  - Franck Nijhof
 comments: true
 categories:
   - Announcements