MagicMirror 是一个开源的模块化智能镜子平台。随着可安装模块列表的增加， MagicMirror²可让您将走廊或浴室镜子转换为您的个人助理。
哀求硬件
MagicMirror² 是为在 Raspberry Pi 上运行而开拓的。它可能（并且将会）在各种不同类型的硬件上运行，但新版本只能在 Raspberry Pi 上进行测试。
Electron是 MagicMirror² 的运用程序包装器，仅支持 Raspberry Pi 2、3 和 4。目前不支持 Raspberry Pi 0/1。如果您想在 Raspberry Pi 1 上运行它，请利用仅做事器功能并自己设置全屏浏览器。
操作系统
请把稳，您须要安装最新的完全版 Raspbian，不要利用 Lite 版本。
节点
虽然旧版本的 Node 可能会事情，但我们建议您利用 Node 16。
安装和利用手动安装
***并安装最新的Node.js版本：curl -sL https://deb.nodesource.com/setup_16.x | sudo -E bash -sudo apt install -y nodejs克隆存储库并检讨主分支：git clone https://github.com/MichMich/MagicMirror进入仓库：cd MagicMirror/安装运用程序：npm install --only=prod --omit=dev制作配置示例文件的副本：cp config/config.js.sample config/config.js启动运用程序：仅做事器npm run start利用：.npm run server自动安装脚本
sudo apt install libffi-dev nginx-full -ypython3 -m pip install --upgrade --no-cache-dir mmpmmmpm --guided-setupecho 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
码头工人形象
MagicMirror² 可以利用Docker进行支配。Kubernetes Helm 图表
如果您想在 kubernetes 集群中运行 MagicMirror²（仅在做事器模式下），请查看此MagicMirror Helm Chart。魔镜操作系统
这是一个基于 Raspbian 的完全操作系统。
解压缩映像并将其安装到 SD 卡，就像任何其他 Raspberry Pi 映像一样magicmirroros-wpa-supplicant.***像闪存驱动器一样利用闪存卡时，通过在闪存卡的根目录进行编辑来配置您的 WiFi从 SD 卡启动 Pi主机名是magicmirroros（不像raspberrypi往常那样），用户名：pi和初始密码是：raspberry您可以在位于的文件中变动 MagicMirror 的设置~/magicmirror/mounts/哀求
Docker 或 Vagrant，推举利用 dockerDocker-compose - 如果利用 docker build 方法，建议利用，解释假设您拥有它已***Raspbian Lite映像。chroot 的根权限重击sudo（脚本本身调用它，没有 sudo 以 root 身份运行将不起浸染）构建 MagicMirrorOSMagicMirrorOS 可以利用在英特尔或 RaspberryPi 上运行的 docker 构建（列出了支持的）。构建须要大约 4.5 GB 的可用空间。您可以假设您已经安装了 docker 和 docker-compose 并发出以下命令来构建它：
git 克隆 https://github.com/guysoft/MagicMirrorOS.gitcd MagicMirrorOS/src/imagewget -c --trust-server-names 'https://downloads.raspberrypi.org/raspios_armhf_latest'光盘..sudo docker-compose up -dsudo docker exec -it magicmirroros-build build构建 MagicMirrorOS 变体
MagicMirrorOS 支持构建变体，这些变体是在主版本构建中进行了变动的构建。文件夹中供应了示例和其他变体src/variants/example。
要构建变体，请利用：
sudo docker exec -it magicmirroros-build build [变体]利用 Vagrant 构建
有一个 vagrant 机器配置可以让您构建 MagicMirrorOS，以防您的构建环境表现不同。除非您进行额外配置，否则 vagrant 必须以 root 身份运行才能使 nfs 文件夹同步事情。
要利用它：
sudo apt-get install vagrant nfs-kernel-serversudo vagrant 插件安装 vagrant-nfs_guestsudo modprobe nfscd MagicMirrorOS/src/vagrantsudo vagrant up
配置机器后，还可以运行从 devel 更新的每晚构建，利用：
cd MagicMirrorOS/src/vagrantrun_vagrant_build.sh
要在机器上构建一个变体，只需运行：
cd MagicMirrorOS/src/vagrantrun_vagrant_build.sh [变体]用法如果须要，通过创建一个新文件来覆盖现有的配置设置src/config.local。您可以覆盖在 中找到的所有设置src/config。如果您须要覆盖 Raspbian 映像的路径以用于构建 MagicMirrorOS，请覆盖要在ZIP_IMG. 默认情形下，将利用-raspbian.zip在 中找到的最新文件匹配。src/build_dist以 root 身份运行。终极图像将在src/workspace其他操作系统
视窗：
要让 MagicMirror 软件在 Windows 上运行，除了上述步骤之外，您还须要做两件事：
4a。在供应商和字体目录中安装依赖项：
电源外壳：
cd fonts; npm install; cd ..cd vendor; npm install; cd ..命令提示符：
cd fonts && npm install && cd ..cd vendor && npm install && cd ..否则启动 MagicMirror 时屏幕将保持玄色。
5a。修复文件中的启动脚本package.json：
导航到文件package.json找到它说的地方"start": "DISPLAY=\"${DISPLAY:=:0}\" ./node_modules/.bin/electron js/electron.js", "start:dev": "DISPLAY=\"${DISPLAY:=:0}\" ./node_modules/.bin/electron js/electron.js dev",并将其更换为"start": ".\\node_modules\\.bin\\electron js\\electron.js", "start:dev": ".\\node_modules\\.bin\\electron js\\electron.js dev",否则程序将无法启动，但会显示以下缺点： "'DISPLAY' is not recognized as an internal or external command, operable program or batch file."升级指南如果您想将您的 MagicMirror² 更新到最新版本，请利用您的终端转到您的 Magic Mirror 文件夹并输入以下命令：
git pull && npm install --only=prod --omit=dev
键入git status以查看您的变动，如果有任何变动，您可以利用 重置它们git reset --hard。在那之后，git pull该当是可以的。
模块钟该clock模块是魔镜的默认模块之一。此模块显示当前日期和韶光。信息将实时更新。
截屏
利用模块
要利用此模块，请将其添加到config/config.js文件中的 modules 数组中：
modules: [ { module: "clock", position: "top_left", // This can be any of the regions. config: { // The config property is optional. // See 'Configuration options' for more information. }, },];日历
该calendar模块是魔镜的默认模块之一。此模块显示来自公共 .ical 日历的事宜。它可以组合多个日历。
利用模块
要利用此模块，请将其添加到config/config.js文件中的 modules 数组中：
modules: [ { module: "calendar", position: "top_left", // This can be any of the regions. Best results in left or right regions. config: { // The config property is optional. // If no config is set, an example calendar is shown. // See 'Configuration options' for more information. }, },];当前景象
该currentweather模块是魔镜的默认模块之一。该模块显示当前景象，包括风速、日落或日出韶光、温度和显示当前状况的图标。
截屏
利用模块
要利用此模块，请将其添加到config/config.js文件中的 modules 数组中：
modules: [ { module: "currentweather", position: "top_right", // This can be any of the regions. // Best results in left or right regions. config: { // See 'Configuration options' for more information. location: "Amsterdam,Netherlands", locationID: "", //Location ID from https://bulk.openweathermap.org/sample/city.list.json.gz appid: "abcde12345abcde12345abcde12345ab", //openweathermap.org API key. }, },];景象预报
截图
利用模块
要利用此模块，请将其添加到config/config.js文件中的 modules 数组中：
modules: [ { module: "weatherforecast", position: "top_right", // This can be any of the regions. // Best results in left or right regions. config: { // See 'Configuration options' for more information. location: "Amsterdam,Netherlands", locationID: "", //Location ID from https://bulk.openweathermap.org/sample/city.list.json.gz appid: "abcde12345abcde12345abcde12345ab", //openweathermap.org API key. }, },];模块开拓文档
模块构造
所有模块都加载到modules文件夹中。modules/default默认模块在文件夹中组合在一起。您的模块应放置在modules. 请把稳，您在文件夹中创建的任何文件或文件modules夹都将被 git 忽略，从而许可您升级 MagicMirror² 而不会丢失文件。
一个模块可以放在一个文件夹中。或者可以将多个模块分组到一个子文件夹中。请把稳，模块的名称必须是唯一的。纵然将具有相似名称的模块放在不同的文件夹中，也无法同时加载它们。
文件
modulename/modulename.js - 这是您的核心模块脚本。modulename/node_helper.js - 这是一个可选的帮助器，将由节点脚本加载。节点助手和模块脚本可以利用集成的套接字系统相互通信。modulename/public - 此文件夹中的任何文件都可以通过/modulename/filename.ext.modulename/anyfileorfolder核心模块脚本可以利用模块文件夹中的任何其他文件或文件夹。例如：modulename/css/modulename.css将是您添加其他模块样式的好路径—END—
开源协议：MIT License
开源地址：https://github.com/MichMich/MagicMirror
