Files
kobrax-lan-hass-component/README.md
2026-05-21 00:31:36 -10:00

2.3 KiB

Kobra X LAN for Home Assistant

Home Assistant integration for monitoring and controlling an Anycubic Kobra X through KX-Bridge.

This project was coded with AI assistance and should be reviewed before use in production.

Architecture:

  • printer <-> KX-Bridge <-> this integration <-> Home Assistant

Requirements

  • Running and reachable KX-Bridge-Release
  • Bridge endpoint accessible from Home Assistant at http://<bridge-host>:7125

Installation

Option 1: HACS

  1. In HACS, add this repository as a custom repository (category: Integration): https://github.com/gangoke/kobrax-lan-hass-component
  2. Install Kobra X LAN from HACS.
  3. Restart Home Assistant.
  4. Go to Settings -> Devices & Services -> Add Integration.
  5. Search for Kobra X LAN.

Option 2: Manual (local custom_components)

  1. Copy the kobrax_lan folder into your Home Assistant custom_components directory: <config>/custom_components/kobrax_lan
  2. Restart Home Assistant.
  3. Add Kobra X LAN from Settings -> Devices & Services.

Configuration

The config flow asks for:

  • Host: KX-Bridge host and port (example: 192.168.1.50:7125)
  • Printer name: Friendly display name in Home Assistant

Entity Overview

Platform Key Entities
Binary Sensor Online, Printing, Light State
Sensor State, Print State, Progress, Temperatures, Filename, Layer/Time metrics, Skip-object counts, ACE status, AMS/ACE slot material
Button Pause Print, Resume Print, Cancel Print, Connect Bridge, Disconnect Bridge, Refresh Skip State, ACE Dryer Start, ACE Dryer Stop
Switch ACE auto-fill switches per detected ACE unit
Number ACE dry target temperature, ACE dry duration
Select Print speed
Light Printer light
Camera Printer camera
Image G-code thumbnail

Slot entities are generated dynamically from KX-Bridge AMS/ACE slot data (including larger ACE topologies).

Notes

  • This integration communicates with KX-Bridge HTTP endpoints and does not connect directly to the printer.
  • Keep KX-Bridge and Home Assistant on a trusted local network.
  • Native WebRTC is not implemented. For WebRTC in Home Assistant, point go2rtc (or another WebRTC-capable add-on) to the camera RTSP source.