Skip to content
Home Assistant TestFlight
Lighting

Creality WebSocket Integration

3dg1luk43/ha_creality_ws · vv0.9.9

HACSLocal push

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.

EntityShows up asNote
lightLight
fanFan
cameraCameraNeeds its own HomeKit Bridge in accessory mode
sensorSensor (temperature, humidity, air quality…)
buttonButton (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
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Creality Ender 3 V3 / KE / PlusWorks LocalNo box temp or light; optional MJPEG camera
Saved 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 HiWorks LocalLight and camera, no box temperature
Saved 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 K1Works LocalBox temperature sensor, light, MJPEG camera
Saved 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 MaxWorks LocalBox temperature, light, camera; CFS support built on it
Saved copy
This 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 SEWorks LocalNo box temperature or light; optional MJPEG camera
Saved 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 K1CWorks LocalBox temperature, light, MJPEG or WebRTC camera
Saved copy
Supported 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 K2Works LocalBox temp control, light, WebRTC camera
Saved 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 CFSWorks LocalCFS not detected initially; fix released in v0.9.1
Saved 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 PlusWorks LocalModel detection fixed; box temp control, light, WebRTC camera
Saved 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 ProWorks LocalBox temp control, light, WebRTC camera
Saved 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 stars99
Latest versionv0.9.9 (2026-10-08)
Set up in the UIYes
Maintainers@3dg1luk43
LicenseAGPL-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.