Creality K series integration

Share your Projects! Custom Integrations
1

Hey all, I’ve been working on Creality K-series printer integration and custom card. I’m still ironing out bugs and currently K2 webrtc camera is not yet supported. K1/K1C/K1 Plus MJPEG based camera stream should work. Enjoy!

image
image534×170 6.15 KB

image
image533×170 7.44 KB

4 Likes
2

support for K2 family and Ender 3 V3 added. Support for Webrtc video (K2 family) will be added with HA 2025.11 release as we’re for go2rtc bump.

1 Like
3

Just found this and it seems to work better than the moonraker integration I was using. Even the camera on my K2 Plus is now working in Home Assistant. I’ve been trying to get that working since I got this printer.

The only thing I’ve noticed is it initially created a chamber (box) target, but then it became unavailable and I’m not sure why.

Other than that, it seems to work very well, and is quick and responsive to update printer status. And the custom card is pretty nice too, all the info you need, in a very compact space.

Well done and thank you!

4

I updated the model detection logic and released a pre-release version of v0.6.3.6-alpha. You have to manually download it in HACS by going into three-dots-menu , pressing redownload and selecting this version
image

5

v0.6.4 - Officially part of HACS default repo

What’s new

  • More reliable model detection and onboarding (waits briefly for telemetry and falls back to board codes).

  • Creality Hi (F018) corrected: no box temperature sensor/control — light and MJPEG camera only.

  • README updated with direct HACS & config-flow badges; CI/static tests added for the project.

If you hit any issues, create issue on github and please share logs and the integration diagnostic output so we can help.

6

Really like the speed this updates compared to the Moonraker integration. Some minor points:

  • Would it be possible to change the light to a light entity and the fans to fan entities instead of number entities ?

  • Change “Box” to “Chamber” ?

  • Total Layers seems to always be zero - EDIT: This seems to be how creality is reporting it, so probably nothing you can do - webpage view:

    image
    image505×124 3.84 KB

  • Is it possible to add the model thumbnail ?

  • MCU Temperature ?

  • Change the sensors so the units can be changed in the UI - for example Used Material Length is in cm and I’d want to change to mm or m

7

Hey! All really great feedback. I creted issues based on this feedback on github.

1.) will do, sounds great
2.) will do, I wanted to do it sooner but got lazy rewriting in everywhere and got used to “box”
3.) This is most probably not grabbed correctly from your printer because it worked on K1C… Could you please share diagnostic output in DM? Refer to README on github.
4.) would you like to have it exposed as URL to thumbnail? camera with single mjpeg? afaik there is no picture entity domain in HA
5.) afaik this is not reported my standard creality firmware. Moonraker depends on different firmware and can access everything on MCU so I dont think this is possible with factory default firmware.
6.) Will add device class and unit of measurement

8

1.) will do, sounds great - :+1:

2.) will do, I wanted to do it sooner but got lazy rewriting in everywhere and got used to “box” - :+1:

3.) This is most probably not grabbed correctly from your printer because it worked on K1C… Could you please share diagnostic output in DM? Refer to README on github. - I have a K1C too so not sure why, as I say the webpage shows it incorrect as well so assume its because its rooted and funning moonraker.

4.) would you like to have it exposed as URL to thumbnail? camera with single mjpeg? afaik there is no picture entity domain in HA - Moonraker does it with a camera entity, but there is a home assistant image entity ?

5.) afaik this is not reported my standard creality firmware. Moonraker depends on different firmware and can access everything on MCU so I don’t think this is possible with factory default firmware. - :+1:

6.) Will add device class and unit of measurement - :+1:

9

v0.6.5 – Print Preview + Entity Upgrades

v0.6.5 is out, rolling up everything since 0.6.4 (including the 0.6.5-alpha changes) with polish and docs.

Highlights:

  • Current Print Preview image for all supported printers (HTTPS→HTTP fallback, cached, no cloud).
  • Lovelace card refinements: optional Power chip (optimistic, pinned right), Light chip mirrors HA state (no optimistic flicker).
  • Diagnostics service (ha_creality_ws.diagnostic_dump): now includes printer‑local HTTP URL attempts for support; TypeError on notification fixed.
  • Chamber terminology adopted in UI (entity IDs unchanged for backward compatibility).

Entity updates:

  • Light migrated to proper light domain with supported_color_modes=onoff.
  • Fan controls moved from number.fan_X → fan.fan_X.
  • Added device_class + units across temperature, distance, progress, time sensors.
  • Axis positions & material used sensors now use distance units and respect HA unit conversions.
  • Real-Time Flow keeps engineering unit [mm³/s] (no device_class to avoid HA warnings).

Other:

  • Model-aware onboarding & capability promotion.
  • WebRTC (K2 family) and MJPEG (others) camera logic solidified.

Bug Fix:

  • Diagnostic service persistent notification no longer throws a TypeError.

Upgrade tips:

  • Hard refresh your dashboard after updating (Ctrl+F5 / ⌘+Shift+R or Reload Resources in the app).
  • Verify the card resource if using YAML mode: /ha_creality_ws/k_printer_card.js.

Feedback & issues:
Report problems or edge-case printer model data at:
https://github.com/3dg1luk43/ha_creality_ws/issues

10

Version 0.7.0 - Release Summary

What’s New

Better Network Resilience

  • MAC-based discovery auto-detects IP changes (perfect for DHCP networks)

  • Editable host in options without recreating entry

Improved WebRTC Camera

  • Now uses official go2rtc-client library for better K2 support

  • Server version validation & error handling

Smart Power Detection

  • Pauses connection attempts when printer is OFF (saves resources)

  • Auto-reconnects when power returns

Card Customization

  • Custom buttons for any entity type

  • Custom MDI icons for all buttons

  • Hide chamber temp option

Expanded Domains

  • Power & light now support input_boolean and light (not just switch)

Installation

Update through HACS → Restart HA → Hard refresh browser (Ctrl+F5)

Compatibility

Fully backward compatible - no breaking changes, existing configs work as-is

Requirements: Home Assistant 2024.11+ | Dependencies: go2rtc-client>=0.1.0

2 Likes