mirror of
https://github.com/gangoke/kobrax-lan-hass-component.git
synced 2026-06-09 20:52:13 +02:00
2.3 KiB
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
- In HACS, add this repository as a custom repository (category: Integration):
https://github.com/gangoke/kobrax-lan-hass-component - Install Kobra X LAN from HACS.
- Restart Home Assistant.
- Go to Settings -> Devices & Services -> Add Integration.
- Search for Kobra X LAN.
Option 2: Manual (local custom_components)
- Copy the
kobrax_lanfolder into your Home Assistantcustom_componentsdirectory:<config>/custom_components/kobrax_lan - Restart Home Assistant.
- 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.