mirror of
https://github.com/gangoke/kobrax-lan-hass-component.git
synced 2026-07-25 11:05:22 +02:00
cd189e3987
- Auto-discover sibling printers on multi-printer KX-Bridge instances via /kx/printers and offer to add them during config flow. - ACE dryer target temp/duration numbers now persist across HA restarts (RestoreNumber) instead of resetting to defaults. - Fix a duplicate async_turn_off definition on KobraXBridgeSettingSwitch that shadowed the real one and crashed with AttributeError; restore the correct method on KobraXAceAutoFeedSwitch where it belonged.
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
Multi-printer setups
KX-Bridge can run multiple printers from a single instance, each on its own port. After adding the first printer, the config flow checks the bridge for sibling printers and offers to add any that aren't configured yet as separate devices — no need to manually look up each port.
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). - ACE dryer target temperature and duration (Number entities) now survive Home Assistant restarts.