MagicMirror² is an open source modular smart mirror platform. With a growing list of installable modules, the MagicMirro
MagicMirror
智能家居
智能家居
已发布
项目简介
MagicMirror² is an open source modular smart mirror platform. With a growing list of installable modules, the MagicMirro
标签
项目特点
**模块化插件系统**：支持数百个社区模块，可自由组合天气、日历、新闻、语音、交通、股票等各类信息显示。
**树莓派驱动**：专为 Raspberry Pi 优化，低功耗运行，适合 7 寸到 32 寸各类屏幕。
**美观的镜面效果**：搭配单向透视玻璃，实现“镜中显示”的科技感视觉效果。
**高度可定制**：支持自定义布局、主题、动画效果，可通过 CSS 和配置文件深度调整。
**活跃社区生态**：23.5K+ GitHub 星标，大量第三方模块和插件持续更新。
**MIT 许可证**：完全开源免费，可商用、可修改，无任何限制。
技术规格
| 运行平台 | Raspberry Pi 2/3/4/5（推荐 Pi 4 或 5） |
|---|---|
| 操作系统 | Raspberry Pi OS（推荐 64-bit） |
| 核心语言 | JavaScript (Node.js) |
| Node.js 版本 | 推荐 v18.x 或 v20.x LTS |
| 显示接口 | HDMI（支持 7"-32" 显示器） |
| 屏幕分辨率 | 最低 800×480，推荐 1920×1080 |
| 镜像玻璃 | 单向透视玻璃（透光率 30%-50%） |
| 网络连接 | Wi-Fi 或以太网 |
| 电源输入 | 5V/3A（树莓派标准供电） |
| 框架类型 | Electron 桌面应用 |
| 模块管理 | npm 包管理器 + 内置模块安装器 |
| 默认端口 | 8080（HTTP 接口） |
项目资源
物料清单 (BOM)
| 物料名称 | 数量 | 参考价格 | 备注 |
|---|---|---|---|
| Raspberry Pi 4/5 | 1 | — | 推荐 4GB 及以上内存版本 |
| MicroSD 卡（32GB+） | 1 | — | 用于安装操作系统 |
| 显示器/屏幕 | 1 | — | 7"-32" HDMI 显示器，推荐 1080p |
| 单向透视玻璃 | 1 | — | 尺寸与屏幕匹配，透光率 30%-50% |
| 电源适配器 | 1 | — | 5V/3A USB-C（树莓派专用） |
| 木框/铝框 | 1 | — | 用于固定屏幕和玻璃 |
| 亚克力背板 | 1 | — | 可选，用于保护背面 |
| HDMI 线缆 | 1 | — | 长度根据机箱设计选择 |
| USB 键盘/鼠标 | 1套 | — | 仅初始设置时使用 |
| Wi-Fi 模块 | 1 | — | 树莓派内置，无需额外购买 |
| 触摸屏 | 1 | — | 支持触摸交互的显示器 |
| 摄像头模块 | 1 | — | 用于手势识别或人脸检测 |
| 麦克风阵列 | 1 | — | 用于语音助手模块 |
所需工具
树莓派/开发板
必需
电池/电源
摄像头模块
能力画像
**记忆与知识检索**：3/5 — 需要查阅官方文档和社区模块说明，但整体配置流程有清晰指南。
**动手与操作**：4/5 — 需要组装硬件框架、连接屏幕和树莓派，涉及一定的物理搭建能力。
**编程与算法**：3/5 — 基础使用无需编程，但自定义模块和修改配置需要 JavaScript 和 Node.js 知识。
**设计与建模**：2/5 — 需要设计镜框外观和布局，但主要依赖现成模板和 CSS 调整。
**实验与调试**：3/5 — 模块兼容性测试、日志排查和硬件连接调试需要一定耐心。
**协作与分享**：4/5 — 社区活跃，可提交模块、参与论坛讨论、贡献代码。
**学习与研究**：4/5 — 涉及智能家居、物联网、前端开发等多个领域知识，学习曲线适中。
**系统集成**：4/5 — 可集成天气 API、日历服务、语音助手、智能家居设备等多种外部系统。
所需技能
基础 Linux 命令行操作（SSH、文件编辑、服务管理）
Node.js 和 npm 包管理基础
JavaScript 基础（用于模块开发和配置修改）
硬件组装能力（连接树莓派、屏幕、电源）
基础网络配置（Wi-Fi 设置、端口转发）
CSS 样式调整（用于自定义界面外观）
故障排查和日志阅读能力
适用场景
智能家居信息中心：在玄关或客厅显示天气、日历、新闻、交通信息
个人助理魔镜：集成语音助手、待办事项、闹钟提醒
企业展示看板：在办公室或前台展示公司公告、日程、KPI 数据
家庭相册魔镜：循环播放家庭照片，叠加日期和时间
智能镜子化妆台：集成灯光控制、皮肤护理提醒、穿搭建议
教育展示工具：在教室或实验室展示课程表、倒计时、通知
智能酒店客房：显示欢迎信息、酒店服务、当地天气和景点推荐
创客空间项目：作为学习 IoT、前端开发和硬件集成的实践项目