Creality WebSocket Integration voor Home Assistant (Marketplace-integratie)

Installaties: 1,6K die analysegegevens delen
GitHub-sterren: 100
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v0.9.9, 27 oktober 2026
Categorie: Computers en netwerk, Printers
Soort: Marketplace-integratie
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: ha_creality_ws
Bron: github.com/3dg1luk43/ha_creality_ws
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Screenshots Uit de README van 3dg1luk43/ha_creality_ws.

Over dit item

Creality WebSocket Integration verbindt Creality K-series en compatibele 3D-printers met Home Assistant via een lokale WebSocket. De integratie ontvangt gepushte updates zonder cloudtoegang en voegt sensoren, knoppen, ventilatoren, een licht, nummerbesturing voor snelheid, doorvoer en doeltemperaturen en een afbeelding met afdrukvoorbeeld toe. Het cameratype, MJPEG of WebRTC, wordt herkend aan het printermodel, en in de opties kun je een eigen camera-URL of een externe go2rtc instellen. Er kan een entiteit voor een stroomschakelaar worden gekoppeld, zodat de printer correct als uit wordt weergegeven, en de acties omvatten CFS-filamentinformatie en -instellingen plus een diagnostische dump. Meldingen op je telefoon kunnen een live afdrukkaart tonen, met keuzes voor meldingen bij voltooiing, fouten en kort voor het einde. Er is een meegeleverde Lovelace-kaart inbegrepen en de installatie gebeurt in de UI door het IP-adres van de printer en een naam in te voeren, of via netwerkdetectie.

Automatische samenvatting van de README en de code van 3dg1luk43/ha_creality_ws, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Wordt vanzelf gevonden Home Assistant vindt het op het netwerk en biedt aan om het toe te voegen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Lichten
Ventilatoren
Camera’s
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Verbinden met Creality-printer

IP-adres
Vriendelijke naam

Na het instellen

Camerastreamingmodus
Externe go2rtc-host/URL (indien nodig)
Externe go2rtc-poort
go2rtc RTSP-poort (0 = automatisch: 18554 ingebouwd, 8554 extern)
Meldingen verzenden naarKies er een of meer. Alleen doelen van de Home Assistant companion-app kunnen de live afdrukkaart, het G-code-voorbeeld of de knoppen tonen; elk ander notify-platform ontvangt alleen de titel en het bericht.
Live afdrukkaartEén melding voor de hele afdruk die ter plekke wordt bijgewerkt, met een voortgangsbalk en een aftelling die op de telefoon doortikt.
Wanneer een afdruk eindigtDekt beide eindes: een afdruk die klaar is en een afdruk die is gestopt, of dat nu vanaf de printer, de Creality-app of Home Assistant gebeurde.
Fouten en leeg filamentEen printerfout of een spoel die leeg is.
Kort voor het einde van een afdrukEen herinnering om de laatste lagen te bekijken, los verzonden zodat de live kaart hem niet kan vervangen.
Hoe lang van tevoren
Knoppen voor pauzeren, hervatten en stoppenStoppen vraagt om apparaatverificatie, zodat een verkeerde tik op een toegangsscherm geen lange afdruk kan beëindigen.
G-code-voorbeeld als pictogramWordt overgeslagen als de printer geen voorbeeld heeft om te leveren, in plaats van een leeg grijs vak te sturen.
Camerasnapshot als een afdruk eindigtHoe het bed er werkelijk uitziet. Wordt overgeslagen bij printers waarvan de camera geen stilstaand beeld kan maken.
Dashboardpad om te openen bij tikkenBijvoorbeeld /lovelace/printer. Als dit leeg blijft, opent een tik op Android de printercamera en een tik op iOS de app; dit is de enige manier om een tik op iOS naar een specifieke plek te laten gaan.
Live afdrukkaart
Afdruk voltooid
Afdruk gestopt
Kort voor het einde
Printerfout
Detectie van stroomschakelaar inschakelen
Entiteit van stroomschakelaar
IP-adres van printer
Pollingfrequentie (seconden, 0 = realtime)

Teksten uit de code van 3dg1luk43/ha_creality_ws. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

KnoppenThuispositie (XY, daarna Z), Afdruk pauzeren, Afdruk hervatten, Afdruk stoppen, Opnieuw verbinden
Camera’sPrintercamera
VentilatorenModelventilator, Behuizingsventilator, Zijventilator
AfbeeldingenVoorbeeld huidige afdruk
LichtenLicht
NummersSnelheidsfactor, Doorvoerfactor, Nozzledoel, Beddoel, Kamerdoel
SensorenBeddtemperatuur, Kamertemperatuur, Nozzletemperatuur, Afdrukvoortgang, Totaal aantal lagen, Huidige laag, Positie X, Positie Y, Positie Z, Afdruksnelheid, Doorvoersnelheid, Realtimesnelheid en nog 20

Acties

Diagnostische dumpVerzamel diagnostiek van elke Creality-printer en geef die als antwoord terug, voor het oplossen van problemen. Wordt ook naar het logboek geschreven.Velden: Gevoelige gegevens opnemen
CFS-info opvragenVraag de printer handmatig om de nieuwste CFS-informatie (multifilament) te sturen, inclusief temperaturen, luchtvochtigheid en filamentgegevens.Velden: Apparaat
CFS-materiaal instellenSchrijf filamentinstellingen naar één CFS-slot. Alleen de velden die je opgeeft worden gewijzigd; laat een veld weg om de waarde te behouden die de printer al heeft. Het materiaaltype is verplicht en mag niet leeg zijn, en een kleur, als je die opgeeft, moet uit zes hexadecimale cijfers bestaan.Velden: Apparaat, Box-ID, Slot-ID, Materiaaltype, Materiaalnaam, Leverancier, Kleur, Minimumtemperatuur, Maximale temperatuur, Pressure Advance

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.

Uit de README

This custom Home Assistant integration provides native, low-latency WebSocket control and telemetry for Creality K‑series and compatible 3D printers. It exposes live state, sensors, controls, a camera stream, and a printer‑local Current Print Preview image. A standalone Lovelace card (no external card dependencies) is bundled.
Direct WebSocket connection (local, no cloud).
Push updates; no polling.
States: idle, processing, printing, paused, stopped, completed, error, self-testing.
Optional power switch binding to a switch entity for accurate "Off" handling.
Entities: status, progress, time left, temperatures (nozzle/bed/chamber), current layer/total layers, etc.
Image (print preview): shows the current model image for all supported printers when available; falls back to a tiny placeholder when not applicable.
Controls: pause, resume, stop, light toggle, fan speeds (model / case / side), temperature targets.
Camera: auto-detects stream type (MJPEG or WebRTC) from the model and what the printer reports.
Lovelace card: dependency-free, uses HA fonts, progress ring, contextual chips, telemetry pills.
Style Editor: Built-in theme customization for every card element, with a device picker that wires up all the entities in one go.
Live print notifications to any number of phones: a countdown timer and progress bar on the iOS Lock Screen and the Android status bar, the G-code preview as the icon, a camera snapshot when a print…

Uit de README van 3dg1luk43/ha_creality_ws, GNU AGPL v3.0. Ingekort.