Проекты
zigporter — CLI-тулкит для Zigbee в HomeAssistant: миграция ZHA ↔ Zigbee2MQTT, каскадный rename…
zigporter — CLI-тулкит для Zigbee в HomeAssistant: миграция ZHA ↔ Zigbee2MQTT, каскадный rename entity/device и радиальная карта mesh с LQI.

ПроектыHomeAssistantZ2MHome AssistantZigbeeLQIZHAHA
🧰 zigporter (https://github.com/nordstad/zigporter) — #CLI-тулкит для #Zigbee в #HomeAssistant: миграция #ZHA ↔ #Zigbee2MQTT, каскадный rename entity/device и радиальная карта mesh с #LQI.
Если вы когда-нибудь переезжали с #ZHA на #Z2M (или обратно) и потом неделю ловили light.xxx_2, битые карточки и «мёртвые» device entries - вот как раз про эту боль. Не ещё одна теория про «какой стек лучше», а рабочий терминальный wizard поверх живого #HA.
✨ Что умеет:
🔁 migrate: #ZHA → #Z2M и #Z2M → #ZHA по одному устройству
🏷 restore имён, area и entity_id после перепривязки
🧹 fix-device / stale: чистка ghost-устройств и суффиксов _2/_3
✏️ rename-entity / rename-device с каскадом по automation / script / scene / #Lovelace
🕸 network-map: radial #SVG mesh с hop-кольцами и LQI-цветными рёбрами
🧩 companion #HACS: live-карта в dashboard через zigporter-hacs
Для #HomeAssistant это утилита «дня переезда и генеральной уборки», а не daily dashboard-игрушка. Особенно полезно, когда mesh уже большой, а руками править registry, dashboard и #MQTT-friendly names страшно.
🏠 Где особенно хорошо зайдёт:
• переезд #ZHA ↔ #Zigbee2MQTT без тотального rename-хаоса
• разбор слабых hop/LQI после перестановки координатора/репитеров
• чистка offline/ghost devices после замены стика или массового re-pair
• аккуратный rename устройств, чтобы не развалились automation и dashboard
Мне здесь нравится практичный угол: не «нарисуй красивую карту», а «перенеси устройство и не убей половину #UI». Карта mesh - бонус, а не главный смысл.
Нюанс: перед migrate обязателен backup #HomeAssistant. Физический factory reset и re-pair всё равно руками. #Jinja2-шаблоны states('old.id') tool не патчит автоматически. Актуальная версия на #PyPI: 1.4.2, нужен Python 3.12+.
GitHub: https://github.com/nordstad/zigporter
HACS map: https://github.com/nordstad/zigporter-hacs
Документация: https://nordstad.github.io/zigporter/
Источник: Home Assistant (https://t.me/home_assistant)
#HomeAssistant #HA #Zigbee #ZHA #Zigbee2MQTT #MQTT #HACS #Lovelace #CLI #Python #УмныйДом #Автоматизация