把旧显示器变成时钟天气屏|MagicMirror²

中文时钟、天气与问候,抬头就看见

用树莓派驱动旧HDMI显示器,做一个能显示中文时间、问候与城市天气的桌面信息屏。固定MagicMirror² v2.38.0和Node 24,配完整BOM、购买地址与八步图解。复用显示器时主控等新增材料规划约¥500–800,预留半天;核心软件MIT,源于成熟开源社区。

alan000

参数信息

核心软件版本
2.38.0 版本

复现文档

接好 Pi 4 与旧显示器

![Pi 4、旧HDMI显示器和各自电源的连接关系](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/b7d46814fe9f431c96674a34f3f4a90f.jpg)让 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)

写入带桌面的 Raspberry Pi OS

让 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)

![在 Imager 中选择带桌面的 Raspberry Pi OS (64-bit)](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/6d437f4857d242c8b58c6d099506077f.png)Raspberry Pi 文档原图,CC BY-SA 4.0;选择带 Desktop 的 64 位系统。

安装 Node 24 并核对版本

准备 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.js 与 npm 的职责和版本检查](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/241c349fb5574f7ba09ac417e160df90.png)工具关系示意:先用 nvm 安装 Node,再由 npm 安装项目依赖。

安装 v2.38.0 并启动默认界面

在 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)

![MagicMirror v2.38.0 默认配置的实际运行界面](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/a91e4e6d87f8457c9dc9fb7f7216b0b9.png)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)

![中文时钟和今天也值得期待的实际运行画面](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/760bcfa92ec0431ca9d7574e775f3559.png)第 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)

![北京当前天气模块实际运行截图](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/92ab1cdcdc1c4f19a5a212e92ad6de66.png)第 6 步的北京坐标运行结果;地点、温度、风速和日落时间随服务数据更新。

调整模块区域,日历保持可选

![magicmirror-layout.png](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/38fada86513f424d952951a3bc80ff9e.png)用模块配置中的 `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)

![中文时钟问候及北京天气的实际完整运行画面](https://orecord-files.oss-cn-zhangjiakou.aliyuncs.com/sbp/projects/696306d1-9c6b-4a2a-88bb-f95e7209f9ca/files/image/c998c230eddf4d6ea75e41d145499fa6.png)三个模块的完整运行画面,可依次核对日期、问候与城市。

相关科技单元