Creality WebSocket Integration
3dg1luk43/ha_creality_ws · vv0.9.9
Creality K1/K2/3V3/Hi WebSocket integration for Home Assistant (local push, MJPEG or webRTC camera, power controls)
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 | |
fan | Fan | |
camera | Camera | Needs its own HomeKit Bridge in accessory mode |
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) |
What people report
Creality K1, K2 and Ender 3 V3 printers work locally over WebSocket. K2-series CFS detection needed fixes, since CFS was first built on a K1 Max.
- Works10
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Creality Ender 3 V3 / KE / Plus | Works Local | No box temp or light; optional MJPEG cameraSaved copy… on firmware 1.3.5.22); K2 - Box temperature sensor & control, light, WebRTC camera; K2 Pro - Box temperature sensor & control, light, WebRTC camera; K2 Plus - Box temperature sensor & control, light, WebRTC camera; Ender 3 V3 - No box temperature, no light, optional MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README | |
| Creality Hi | Works Local | Light and camera, no box temperatureSaved copy… MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README | |
| Creality K1 | Works Local | Box temperature sensor, light, MJPEG cameraSaved copy… MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README | |
| Creality K1 Max | Works Local | Box temperature, light, camera; CFS support built on itSaved copyThis PR introduces full support for Creality Filament System (CFS), including new sensors, a native UI card with a visual editor, and internal refactors to improve extensibility and robustness. ## ✨ What’s new ### CFS Sensors - Added sensors for each CFS box (temperature and humidity) - Added sensors for each CFS slot (filament, color, percent) - Added dedicated sensors for external filament (single slot / type 1) ### CFS Card (Native UI Card) - New Creality CFS Card with a built-in visual editor - Renders one tile per slot and a dedicated tile for the external filament - Supports up to 4 CFS … Excerpt saved from GitHub on 2026-10-23. | PR #61 · 2026-01 | |
| Creality K1 SE | Works Local | No box temperature or light; optional MJPEG cameraSaved copy… MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README | |
| Creality K1C | Works Local | Box temperature, light, MJPEG or WebRTC cameraSaved copySupported devices: K1 - Box temperature sensor only (no control), light, MJPEG camera; K1C - Box temperature sensor only (no control), light, MJPEG camera (WebRTC on firmware 1.3.5.22); K1C (2025) - Box temperature sensor only (no control), light, WebRTC camera (auto-detected; some units show no video, see Camera); K1 SE - No box temperature, no light, optional MJPEG camera; K1 Max - Box temperature sensor only (no control), light, MJPEG camera (WebRTC on firmware 1.3.5.22); K2 - Box temperature sensor & control, light, WebRTC camera; K2 Pro - Box temperature sensor & control, light, WebRTC … Excerpt saved from the README on 2026-10-23. | README | |
| Creality K2 | Works Local | Box temp control, light, WebRTC cameraSaved copy… MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README | |
| Creality K2 Combo with CFS | Works Local | CFS not detected initially; fix released in v0.9.1Saved copy… Assistant Core version: 2026.1.3 - Integration version (from `manifest.json` or HACS): 0.9.0 - Installation method: HACS - Printer model (friendly name): Creality K2 Combo - Printer board/modelVersion code (if shown, e.g. F012, F021): F021 - Connection host/IP: 192.168.20.57 - Camera type (reported or forced): webrtc - Power switch bound?: yes ## Description CFS is not detected. Is there a way to tell the extension that there is an CFS? The build in service just shows me an error message -> See screenshot ## Expected Behavior Show CFS data ## Reproduction Steps - ## Logs & Diagnostics ``` … Excerpt saved from GitHub on 2026-10-23. | Issue #66 · 2026-01 | |
| Creality K2 Plus | Works Local | Model detection fixed; box temp control, light, WebRTC cameraSaved copy… your model detection you are currently assuming that the "model" of the printer has the name somewhere e.g. - `is_k2_family = "k2" in model_l` - `is_k2_plus = is_k2_family and "plus" in model_l` I have a K2 Plus, but the model doesn't list anything with regards to the K2 or plus or alike, so this breaks all the features related to the K2) This is the information from my printer on the websocket that seems to be unique to the K2 Plus: `"model": "F008"` `"modelVersion": "printer hw ver:;printer sw ver:;DWIN hw ver:CR0CN240110C10;DWIN sw ver:1.1.3.13;"` From some brief internet searches the F008 … Excerpt saved from GitHub on 2026-10-23. | Issue #8 · 2025-10 | |
| Creality K2 Pro | Works Local | Box temp control, light, WebRTC cameraSaved copy… temperature sensor only (no control), light, MJPEG camera (WebRTC on firmware 1.3.5.22); K2 - Box temperature sensor & control, light, WebRTC camera; K2 Pro - Box temperature sensor & control, light, WebRTC camera; K2 Plus - Box temperature sensor & control, light, WebRTC camera; Ender 3 V3 - No box temperature, no light, optional MJPEG camera; Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera; Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera; Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise. Excerpt saved from the README on 2026-10-23. | README |
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) | 1,544 (0.22%) |
|---|---|
| GitHub stars | 99 |
| Latest version | v0.9.9 (2026-10-08) |
| Set up in the UI | Yes |
| Maintainers | @3dg1luk43 |
| License | AGPL-3.0 |
Devices listed in its README
- K1 - Box temperature sensor only (no control), light, MJPEG camera
- K1C - Box temperature sensor only (no control), light, MJPEG camera (WebRTC on firmware 1.3.5.22)
- K1C (2025) - Box temperature sensor only (no control), light, WebRTC camera (auto-detected; some units show no video, see Camera)
- K1 SE - No box temperature, no light, optional MJPEG camera
- K1 Max - Box temperature sensor only (no control), light, MJPEG camera (WebRTC on firmware 1.3.5.22)
- K2 - Box temperature sensor & control, light, WebRTC camera
- K2 Pro - Box temperature sensor & control, light, WebRTC camera
- K2 Plus - Box temperature sensor & control, light, WebRTC camera
- Ender 3 V3 - No box temperature, no light, optional MJPEG camera
- Ender 3 V3 KE - No box temperature, no light, optional MJPEG camera
- Ender 3 V3 Plus - No box temperature, no light, optional MJPEG camera
- Creality Hi - No box temperature, light, WebRTC camera where the firmware reports it, MJPEG otherwise
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.
Sources
- Documentation: https://github.com/3dg1luk43/ha_creality_ws
- Source code: https://github.com/3dg1luk43/ha_creality_ws
- Issues: https://github.com/3dg1luk43/ha_creality_ws/issues
- HACS: https://hacs.xyz