mirror of
https://github.com/gangoke/kobrax-lan-hass-component.git
synced 2026-06-09 20:52:13 +02:00
main
Reviewed-on: https://gitea.gangoke.app/gangoke/kobrax-lan-hass-component/pulls/6
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, Hotend Temperature, Target Hotend Temperature, Bed Temperature, Target Bed Temperature, Filename, Current Layer, Total Layers, Remaining Time, Print Duration, Skip Object Count, Skipped Object Count, Filament Mode, ACE Unit Count, Bridge Version, Latest Available Version, Camera Stream Mode, Slot 1..Slot 19, ACE 1..4 Dryer Status, ACE 1..4 Dryer Humidity, ACE 1..4 Dryer Current Temperature, ACE 1..4 Dryer Target Temperature, ACE 1..4 Dryer Remaining Time |
| Button | Pause Print, Resume Print, Cancel Print, Connect Bridge, Disconnect Bridge, Refresh Skip State, Apply Update (KX-Bridge) |
| Switch | Camera On Print, Web Upload Warning, ACE 1..4 Auto Fill, ACE 1..4 Dryer |
| Number | ACE 1..4 Dryer Target Temperature, ACE 1..4 Dryer Duration |
| Select | Print speed, Slot 1..Slot 19 Filament Profile |
| Light | Printer light |
| Camera | Printer camera |
| Image | G-code thumbnail |
Slot and ACE entities are pre-created and automatically enabled/disabled based on detected slot mode and ACE unit count from KX-Bridge.
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.
- Camera streaming prefers the bridge H.264 endpoint (
/api/camera/h264, MPEG-TS passthrough) on newer bridge releases, with RTSP/MJPEG fallback for older releases. - Native WebRTC is not implemented. For WebRTC in Home Assistant, point
go2rtc(or another WebRTC-capable add-on) to the camera source you prefer (H.264 bridge endpoint or RTSP).
Description
v0.2.0
Latest
Languages
Python
100%