产品简介
home-dashboard 这是一个开源模块化家居仪表板，可在本地计算机上运行，收集天气、日历、车辆等数据并生成电子纸显示的图像。适合使用电子纸显示器、希望自定义家居信息显示的技术用户，解决需要本地化、自动刷新数据展示的需求。
核心功能
- 模块化架构，支持天气、日历、车辆等多种数据源
- 本地网络服务运行，数据通过本地服务器提供
- 生成适合电子纸的 1 位 PNG 图像显示
- 定时每 10 分钟自动刷新数据，节省电子纸电池
- 开源免费，基于 MIT 许可可自由定制
快速开始
- 克隆仓库并运行 `npm install` 安装依赖
- 复制 `.env.example` 为 `.env` 文件，设置 `MAIN_LOCATION_ZIP` 和 `VISUAL_CROSSING_API_KEY` 等 API 密钥
- 运行 `npm start` 以 PM2 守护进程启动服务器
- 访问 `http://localhost:7272/dashboard` 查看仪表板或 `http://localhost:7272/dashboard/image` 获取电子纸图像
界面预览
与其他方案对比
| 对比项 | 本工具 | 同类商业软件 | 在线服务 |
|---|---|---|---|
| 费用 | 开源免费 | 通常收费或含广告 | 可能有订阅或上传限制 |
| 隐私 | 本地运行，数据自持 | 依赖厂商政策 | 需上传数据到服务器 |
| 可定制性 | 源码开放，社区活跃 | 受限于官方功能 | 功能固定 |
适合谁用
- 使用电子纸显示器显示天气和日历信息的家庭用户
- 喜欢 DIY 智能家居项目并自定义数据展示的技术爱好者
- 需要本地化运行仪表板、避免云依赖的隐私敏感用户
下载与版本
当前最新版本为 main，发布于 。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/kyleturman/home-dashboard