Creality WebSocket Integration für Home Assistant (Marketplace-Integration)

Installationen: 1.557 teilen Analysedaten
GitHub-Sterne: 100
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v0.9.9, 27. Oktober 2026
Kategorie: Computer und Netzwerk, Drucker
Art: Marketplace-Integration
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: ha_creality_ws
Quelle: github.com/3dg1luk43/ha_creality_ws
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Screenshots Aus der README von 3dg1luk43/ha_creality_ws.

Überblick

Die Creality WebSocket Integration verbindet Creality K-Serien-Drucker und kompatible 3D-Drucker über einen lokalen WebSocket mit Home Assistant. Sie erhält Updates per Push ohne Cloud-Zugriff und fügt Sensoren, Tasten, Ventilatoren, ein Licht, Zahlenregler für Geschwindigkeit, Durchfluss und Temperaturziele sowie ein Druckvorschaubild hinzu. Der Kameratyp, MJPEG oder WebRTC, wird anhand des Druckermodells erkannt, und in den Optionen kann eine eigene Kamera-URL oder ein externes go2rtc festgelegt werden. Eine Schalter-Entität für die Stromversorgung kann verknüpft werden, damit der Drucker korrekt als ausgeschaltet angezeigt wird, und die Aktionen umfassen CFS-Filamentinfos und -Einstellungen sowie einen Diagnose-Dump. Handy-Benachrichtigungen können eine Live-Druckkarte anzeigen, mit Auswahlmöglichkeiten für Hinweise bei Abschluss, Fehlern und kurz vor Druckende. Eine mitgelieferte Lovelace-Karte ist enthalten, und die Einrichtung erfolgt in der Oberfläche durch Eingabe der IP-Adresse des Druckers und eines Namens oder über die Netzwerkerkennung.

Zusammenfassung der README und des Codes von 3dg1luk43/ha_creality_ws, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Wird automatisch erkannt Home Assistant entdeckt sie im Netzwerk und bietet an, sie hinzuzufügen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Lichter
Ventilatoren
Kameras
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Mit Creality-Drucker verbinden

IP-Adresse
Anzeigename

Nach der Einrichtung

Kamera-Streaming-Modus
Externer go2rtc-Host/-URL (falls nötig)
Externer go2rtc-Port
go2rtc-RTSP-Port (0 = automatisch: 18554 integriert, 8554 extern)
Eigene Kamera-URL (http(s) MJPEG/Snapshot oder rtsp://)
Benachrichtigungen senden anWähle ein oder mehrere Ziele. Nur Ziele der Home Assistant Companion App können die Live-Druckkarte, die G-Code-Vorschau oder die Tasten anzeigen; jede andere Notify-Plattform erhält nur Titel und Nachricht.
Live-DruckkarteEine Benachrichtigung für den gesamten Druck, die sich an Ort und Stelle aktualisiert, mit Fortschrittsbalken und einem Countdown, der auf dem Handy mitläuft.
Wenn ein Druck endetDeckt beide Arten des Endes ab: einen abgeschlossenen Druck und einen gestoppten, egal ob am Drucker, in der Creality-App oder in Home Assistant.
Fehler und FilamentendeEin Druckerfehler oder eine leere Spule.
Kurz vor DruckendeEine Erinnerung, die letzten Schichten anzusehen, als eigene Benachrichtigung, damit die Live-Karte sie nicht ersetzen kann.
Wie lange vorher
Tasten für Pause, Fortsetzen und StoppStopp verlangt eine Geräteauthentifizierung, damit ein versehentliches Antippen auf dem Sperrbildschirm keinen langen Druck beenden kann.
G-Code-Vorschau als SymbolWird übersprungen, wenn der Drucker keine Vorschau liefert, statt ein leeres graues Feld zu senden.
Kamera-Snapshot, wenn ein Druck endetZeigt, wie das Druckbett tatsächlich aussieht. Wird bei Druckern übersprungen, deren Kamera kein Standbild aufnehmen kann.
Dashboard-Pfad, der beim Antippen geöffnet wirdZum Beispiel /lovelace/printer. Bleibt das Feld leer, öffnet ein Antippen unter Android die Druckerkamera und unter iOS die App; nur so führt ein Antippen unter iOS an eine bestimmte Stelle.
Live-Druckkarte
Druck abgeschlossen
Druck gestoppt
Kurz vor dem Ende
Druckerfehler
Erkennung des Stromschalters aktivieren
Entität des Stromschalters
IP-Adresse des Druckers
Abfragerate (Sekunden, 0 = Echtzeit)

Texte aus dem Code von 3dg1luk43/ha_creality_ws. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

TastenHome (XY, dann Z), Druck pausieren, Druck fortsetzen, Druck stoppen, Neu verbinden
KamerasDruckerkamera
VentilatorenModelllüfter, Gehäuselüfter, Seitenlüfter
BilderAktuelle Druckvorschau
LichterLicht
ZahlenGeschwindigkeitsfaktor, Flussfaktor, Düsenziel, Bettziel, Kammerziel
SensorenBetttemperatur, Kammertemperatur, Düsentemperatur, Druckfortschritt, Schichten gesamt, Aktuelle Schicht, Position X, Position Y, Position Z, Druckgeschwindigkeit, Durchflussrate, Echtzeitgeschwindigkeit und 20 weitere

Aktionen

Diagnose-DumpSammelt Diagnosedaten für jeden Creality-Drucker und gibt sie als Antwort zurück, zur Fehlersuche. Wird auch ins Log geschrieben.Felder: Sensible Daten einschließen
CFS-Info anfordernFordert den Drucker manuell auf, die neuesten CFS-Informationen (Multifilament) zu senden, einschließlich Temperaturen, Luftfeuchtigkeit und Filamentdetails.Felder: Gerät
CFS-Material festlegenSchreibt Filament-Einstellungen in einen CFS-Slot. Nur die Felder, die du angibst, werden geändert; lass ein Feld weg, um den Wert beizubehalten, den der Drucker bereits hat. Der Materialtyp ist erforderlich und darf nicht leer sein, und eine Farbe muss, falls du eine angibst, aus sechs Hexadezimalziffern bestehen.Felder: Gerät, Box-ID, Slot-ID, Materialtyp, Materialname, Hersteller, Farbe, Minimale Temperatur, Maximaltemperatur, Pressure Advance

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.

Aus der 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…

Aus der README von 3dg1luk43/ha_creality_ws, GNU AGPL v3.0. Gekürzt.