Mastershort/neonplan3d

3D floor plan for Home Assistant: draw your home in the built-in editor (rooms, walls, doors, windows, furniture, roof) and see and control lights, covers, windows, climate, media, sensors and cameras live in a neon 3D view – as a sidebar panel and dashboard card.

NeonPlan 3D – 用于视觉化家居控制的 Home Assistant 集成

它是什么 – NeonPlan 3D 是一个 Home Assistant 集成,让您直接在 Home Assistant 中绘制房屋平面图,并立即看到霓虹风格的 3D 渲染。3D 视图是可交互的:可以切换灯光、移动百叶窗、开门、检查摄像头,家电也会显示其状态。

主要功能

  • 平面图编辑器 – 绘制房间、墙壁、门、窗户、楼梯、屋顶、户外区域;支持自由形状和自动墙壁生成。
  • 实时 3D 视图 – 点击对象进行控制(灯光、百叶窗、门),查看颜色编码的状态、摄像头快照、温度/湿度/CO₂ 的热图。
  • 家具库 – 超过 50 个内置模型,加上可选的家具包(房间、车辆、智能家居设备)。灯具在视图中会发出彩色光。
  • 仪表板卡片 – custom:neonplan3d-card 可以放在任何 Lovelace 仪表板上;许多视觉选项(主题、质量、爆炸视图、警报、天气等)可通过视觉编辑器或 YAML 配置。
  • 壁挂平板 / 信息亭模式 – 针对壁挂平板(例如 Fire 平板)优化,具有空闲返回、夜间调光和全屏信息亭 UI。
  • 警报与自动化 – 显示烟雾、燃气、漏水、下雨开窗警告;与 Home Assistant 场景和脚本集成。
  • 扩展功能 – 可选的付费包(额外家具、Pro 附加组件,如摄像头座舱、室外天气、实时电视屏幕)通过许可证密钥提供,并自动更新。

安装

  • 建议通过 HACS(Home Assistant 社区商店):将仓库添加为自定义集成、安装、重启 Home Assistant,然后从 设置 → 设备与服务 添加集成。
  • 也可以手动安装,方法是复制 custom_components/neonplan3d 文件夹。
  • 需要 Home Assistant 2025.1 或更新版本。

隐私

  • 所有平面图数据、图片和包都存储在 Home Assistant 的 .storage 文件夹中。
  • 唯一的外部调用是在输入付费包的许可证密钥时;服务每天会使用密钥和匿名安装哈希联系 mastershort.de 一次。

开发

  • 前端使用 npm 构建;测试通过 npm test 和 pytest-homeassistant-custom-component 执行 Python 端。
  • 预览模式(preview/index.html)让您可以在没有 Home Assistant 实例的情况下,在浏览器中查看 3D UI。

适用对象

  • 想要以视觉化、平板友好的方式监控和控制智能家居设备的 Home Assistant 用户。
  • 喜欢“霓虹”美学或需要快速绘制平面图以进行自动化调试的人。

链接


以上所有信息直接取自仓库的 README;没有额外声明。

相关

  • 项目
  • 项目
  • 项目
  • 项目