中文时钟、天气与问候,抬头就看见
用树莓派驱动旧HDMI显示器,做一个能显示中文时间、问候与城市天气的桌面信息屏。固定MagicMirror² v2.38.0和Node 24,配完整BOM、购买地址与八步图解。复用显示器时主控等新增材料规划约¥500–800,预留半天;核心软件MIT,源于成熟开源社区。
alan000
让 Pi 4 能向旧屏输出画面,同时保留原显示器外壳和底座。
1. 按 BOM 点清 Pi 4、卡扣外壳、micro-HDMI 至 HDMI 线、Pi 电源、显示器及其原电源;旧键鼠供步骤 2 首次配置使用。
2. 先断开两台设备电源。将 Pi 4 对准外壳卡扣和接口开孔平放压入;阻力异常时先检查方向,不要硬压。
3. 把 micro-HDMI 端插入 Pi 4 靠近 USB-C 电源口的 HDMI0,HDMI 端接显示器输入。该路线用 HDMI0;显示器输入切到对应 HDMI 口。
4. 暂不接通电源;先在步骤 2 写入系统卡,再给 Pi 与显示器分别供电。接线图标明 Pi 4 供电规格 5.1 V / 3 A;电源应与该板卡匹配。
检查:线缆插头完全就位、完成步骤 2 写卡并插卡后再通电;本步骤不拆显示器外壳。图为连接关系示意,不按比例绘制。
[官方硬件与桌面系统要求](https://docs.magicmirror.builders/getting-started/requirements.html)
让 Pi 4 启动到桌面环境;MagicMirror² 的 Electron 界面需要桌面,Lite 版不满足此要求。
1. 在电脑安装 Raspberry Pi 官方 Raspberry Pi Imager,插入读卡器与 32 GB 存储卡。
2. 在 Imager 中选择 Raspberry Pi 4 设备和 Raspberry Pi OS (64-bit) 带 Desktop 的系统映像,不选 Lite。
3. 打开系统自定义设置,填入自己设定的用户名、密码、Wi‑Fi 和时区。
4. 核对目标设备确为要清空的存储卡,再开始写入并等待校验结束。
5. 弹出卡并插入 Pi 4 底部卡槽;接上 USB 键盘、鼠标,给显示器选对 HDMI 输入后接通 Pi 电源。
检查:Pi 进入图形桌面,且可联网。若没有桌面,先检查系统映像是否选成 Lite,再继续软件安装。
[Raspberry Pi Imager 下载](https://www.raspberrypi.com/software/) · [MagicMirror² 系统要求](https://docs.magicmirror.builders/getting-started/requirements.html)
Raspberry Pi 文档原图,CC BY-SA 4.0;选择带 Desktop 的 64 位系统。
准备 Git、下载工具和 MagicMirror² v2.38.0 支持的 Node 运行时。以下命令在 Pi 桌面终端中以普通用户执行。
1. 更新软件包索引并安装 git、curl:
```
sudo apt update
sudo apt install -y git curl
```
2. 下载 nvm v0.40.8 安装脚本到临时文件;先用文本编辑器查看脚本后运行:
```
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh -o /tmp/nvm-install.sh
nano /tmp/nvm-install.sh
bash /tmp/nvm-install.sh
```
退出查看器后运行脚本。nvm 用来安装、选择 Node 版本。
3. 关闭并重新打开终端,然后安装 Node 24 并设为默认版本:
```
nvm install 24
nvm alias default 24
node -v
npm -v
```
检查:`node -v` 显示 v24 开头版本;v2.38.0 的 package.json 要求 Node ≥22.22.2 且 <23,或 ≥24。若终端提示找不到 nvm,先重新登录桌面再检查 nvm 初始化设置,不要继续安装。
[nvm v0.40.8 官方安装说明](https://github.com/nvm-sh/nvm/tree/v0.40.8) · [v2.38.0 Node 要求](https://github.com/MagicMirrorOrg/MagicMirror/releases/tag/v2.38.0)
工具关系示意:先用 nvm 安装 Node,再由 npm 安装项目依赖。
在 Pi 上安装固定版本,确认 Electron 能在桌面启动。
1. 在普通用户主目录确认没有现存的 `~/MagicMirror` 目录;已有目录时先检查其内容,不要覆盖。
2. 克隆 v2.38.0 固定标签并进入目录:
```
cd ~
git clone --branch v2.38.0 --depth 1 https://github.com/MagicMirrorOrg/MagicMirror.git
cd ~/MagicMirror
```
3. 安装生产依赖:
```
node --run install-mm
```
此命令可能长时间少有终端输出,保持联网并等到命令返回提示符。
4. 复制配置样例,再启动:
```
cp config/config.js.sample config/config.js
node --run start
```
`start` 在该版本默认使用 Wayland。若系统桌面切换为 X11,则用 `node --run start:x11`。
检查:显示器出现默认模块界面,终端无安装/启动错误。默认配置会显示英文时间、日历、问候、纽约天气与新闻。黑屏先确认桌面、Node 版本及依赖安装完成。
[官方安装命令与耗时说明](https://docs.magicmirror.builders/getting-started/installation.html) · [v2.38.0 package scripts 与 Node 范围](https://github.com/MagicMirrorOrg/MagicMirror/blob/v2.38.0/package.json)
v2.38.0 默认配置运行画面。默认城市是纽约;后面会改为自己的城市。
只加载时钟与问候,先确认中文字符和模块位置,再添加网络天气。
1. 回到运行 MagicMirror 的终端按 Ctrl+C 退出;先复制配置备份:
```
cd ~/MagicMirror
cp config/config.js config/config.js.backup
```
2. 打开配置文件 `nano config/config.js`,将文件内容替换为下列配置。`localhost` 与 loopback 白名单限制本机访问;模块位置 `top_left`、`lower_third` 对应左上与下方区域:
```
const config = {
address: "localhost",
port: 8080,
ipWhitelist: ["127.0.0.1", "::1", "::ffff:127.0.0.1"],
language: "zh-cn",
locale: "zh-CN",
timeFormat: 24,
units: "metric",
modules: [
{ module: "clock", position: "top_left" },
{
module: "compliments", position: "lower_third",
config: { compliments: { anytime: ["今天也值得期待"] } }
}
]
};
if (typeof module !== "undefined") { module.exports = config; }
```
3. 按 Ctrl+O 保存、Enter 确认、Ctrl+X 退出。运行检查再启动:
```
node --run config:check
node --run start
```
检查:屏幕显示中文日期/时间和“今天也值得期待”。若检查器报告语法错误,按文件位置提示修正;若中文呈方框,可安装 Raspberry Pi OS 软件源中的 Noto CJK 字体:`sudo apt update && sudo apt install fonts-noto-cjk`,安装后重启 MagicMirror。
[v2.38.0 配置样例](https://github.com/MagicMirrorOrg/MagicMirror/blob/v2.38.0/config/config.js.sample) · [时钟配置](https://docs.magicmirror.builders/modules/clock.html) · [问候配置](https://docs.magicmirror.builders/modules/compliments.html)
第 5 步配置运行后的中文时钟与问候。
通过 Open-Meteo 按城市坐标显示当前天气。示例坐标是北京中心点;在其他城市使用时替换成当地公共地标附近的经纬度,无需填家庭精确地址。
1. 停止当前界面,打开 `~/MagicMirror/config/config.js`,在问候模块对象后加逗号,再加入:
```
{
module: "weather",
position: "top_right",
config: {
weatherProvider: "openmeteo",
type: "current",
lat: 39.9042,
lon: 116.4074
}
}
```
`lat` 为纬度,`lon` 为经度;provider、类型和坐标字段均见 v2.38.0 样例。
2. 保存后运行检查并启动:
```
node --run config:check
node --run start
```
检查:右上区域出现天气图标和温度;核对地点对应设定城市。天气数据由 Open-Meteo 网络服务提供。若模块空白,先核对逗号、坐标和终端报错。
[固定版本天气样例](https://github.com/MagicMirrorOrg/MagicMirror/blob/v2.38.0/config/config.js.sample) · [天气模块字段](https://docs.magicmirror.builders/modules/weather.html) · [Open-Meteo 服务条款](https://open-meteo.com/en/terms)
第 6 步的北京坐标运行结果;地点、温度、风速和日落时间随服务数据更新。
用模块配置中的 `position` 改变屏幕区域;日历不是基础安装的必要部分。
1. 在 `config.js` 中找到三个模块对象,修改各自的 `position` 字符串。v2.38.0 内置区域包括 `top_left`、`top_right`、`lower_third` 等。
2. 保存后执行 `node --run config:check`;检查通过再按 Ctrl+C 停止旧界面并重新运行 `node --run start`。
3. 需要日程时再参考官方 calendar 模块说明,单独添加模块和自己的 ICS 订阅 URL。订阅 URL 可能包含访问令牌;只放在本机配置中,不公开配置文件或含 URL 的截图。
检查:模块按所选区域显示;若重叠,调整位置或模块数组顺序。下图说明本教程三个模块的位置设置,完整区域名称见文档链接。
[官方区域名称与布局说明](https://docs.magicmirror.builders/modules/configuration.html) · [可选日历模块](https://docs.magicmirror.builders/modules/calendar.html) · [配置秘密说明](https://docs.magicmirror.builders/configuration/secrets.html)
确认基础功能齐备,并记录重装所需版本信息。
1. 逐项核对中文时钟持续更新、问候文字正确、天气地点为所选城市、调整位置后模块仍显示。
2. 记录系统版本、日期、Node 和仓库版本:
```
cd ~/MagicMirror
git describe --tags --exact-match
node -v
```
3. 停止界面后再次执行 `cd ~/MagicMirror` 和 `node --run start`,确认能重新启动。开机自启是可选项;采用官方桌面模式指南时先用 `which node` 核实 nvm 下 Node 的绝对路径。
4. 正常关机并等待系统结束后再断开 Pi 电源;备份配置前移除私人日历订阅凭证。
检查:四项显示正常,手动重启命令可再次打开界面。保持 localhost/loopback 本机访问设置,不做路由器端口映射;官方文档提醒公网暴露可能泄露配置秘密并增加攻击风险。
[可选开机自启指南](https://docs.magicmirror.builders/configuration/autostart.html) · [安装与公网安全说明](https://docs.magicmirror.builders/getting-started/installation.html)
三个模块的完整运行画面,可依次核对日期、问候与城市。