Crestron Home
homebridge-crestron-home · v1.2.3
Adds Crestron Home lights, shades, thermostats, locks, scenes and security to HomeKit.
What it says it supports
Brands
- Crestron
Devices it names
- Crestron MC4-R
- Crestron Home OS
Shows up in Apple Home as from its README
What people report
Works for Crestron Home lights, shades, scenes, thermostats and locks; limited shade stop and quick actions via Crestron CWS API.
- Works2
- Partly works1
| Device | Status | What they said | Source |
|---|---|---|---|
| Crestron Home lights and shades (OS4) | Works | Stopped after OS4 upgrade; fixed by rebooting controller.Saved copyDescribe The Bug: Plugin is not working, seems to be after upgrading to Crestron Home OS4. To Reproduce: Is constant Expected behavior: Would expect to control lights and shades from Apple HomeKit, they were working, none are working now. Logs: Login error: Request failed with status code 500 [3/24/2024, 8:34:57 PM] [Crestron Home Platform] error getting devices: TypeError: Cannot read properties of undefined (reading 'get') at CrestronClient.getDevices (/volume1/homebridge/node_modules/homebridge-crestron-home/src/crestronClient.ts:75:26) at processTicksAndRejections … Excerpt saved from GitHub on 2026-10-22. | Issue #12 · 2024-03 |
| Crestron Home thermostats and door locks | Works | Thermostat and door lock support merged.Saved copyOpening this, followed the patterns and API docs on https://sdkcon78221.crestron.com/sdk/Crestron-Home-API/Content/Topics/API-Reference/Thermostats-API.htm Tests were passing locally doing some device testing now and will confirm if works, would be easy to fill out the whole api from here. Thanks for the project. Excerpt saved from GitHub on 2026-10-22. | PR #19 · 2025-08 |
| Crestron Home shades | Partly works | Only open/close; no stop, tilt or position via CWS API.Saved copyCWS has two main limitations that I'm aware of: 1. It does really bad job with shades, it doesn't have API to send stop command to a shade. As a result, Homekit has only open/close functionality, no tilt up/down or bring a shade to a certain position (it ignores any other position value other than max up/down). 2. No API to recall quick actions as I mentioned. Crestron support is saying that the CWS server is developed by Crestron Labs, but they closed public registration and Crestron doesn't help with an invite, so it is impossible to get their feedback. I have the same use case as you. I … Excerpt saved from GitHub on 2026-10-22. | Issue #1 · 2022-08 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Crestron Home CWS REST API
You’ll need
- Crestron Home Web API token
Compatibility
| Verified by Homebridge | Yes |
|---|---|
| Homebridge versions | ^1.8.0 || ^2.0.0 |
| Homebridge 2.0 | Yes |
| Node.js | ^20.19.0 || ^22.12.0 || ^24.0.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | CrestronHomePlatform |
| License | Apache-2.0 |
Community signals
| Downloads a week | 11 |
|---|---|
| Downloads a month | 70 |
| GitHub stars | 10 |
| Open issues | 5 |
| Closed issues | 17 |
| Last code push | 2026-07-27 |
| Latest version | 1.2.3 (2026-06-27) |
| First published | 2022-06-20 |
| Releases | 23 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Crashes above 149 devices unless split across child bridges
- Token must be refreshed after firmware upgrades
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- Lightbulb
- LockMechanism
- SecuritySystem
- Switch
- Thermostat
- WindowCovering
