Magic Mirror en Raspberry Pi: Guía Completa de Instalación

Siempre me ha fascinado la idea de tener mi propio espejo inteligente, así que probé el proyecto Magic Mirror con una Raspberry Pi. Sin embargo, la mayoría de las guías complican demasiado las cosas. Por eso, creé una versión sencilla y fácil de usar para principiantes que realmente funciona. ¡Déjame guiarte a través de ella!

Magic Mirror se puede instalar en Raspberry Pi utilizando una configuración manual con Node.js o un script automático. El método más fácil es usar el instalador oficial, que descarga todas las dependencias y configura el sistema automáticamente.

En esta guía, obtendrás una rápida introducción a Magic Mirror y luego te mostraré la mejor manera de instalarlo en Raspberry Pi. Vamos a pasar por consejos de configuración, gestión de módulos y pequeños ajustes para mejorar la experiencia general. Siéntete libre de saltar a las partes que necesitas.

Introducción al proyecto Magic Mirror

Al igual que jugar a juegos clásicos en Retropie (en inglés) o ver Netflix con Kodi (en inglés), construir un Magic Mirror es un proyecto que ayudó a popularizar la Raspberry Pi. Una vez terminado, es una realización realmente atractiva y sigue siendo algo futurista para poner en tu casa, lo que despertó el interés de muchos creadores.

Michael Teeuw es el inventor original del proyecto Magic Mirror, y puedes encontrar muchos recursos sobre el mismo en su sitio web. Como aprenderemos más tarde, construir un Magic Mirror no es tan complicado como podrías pensar, pero en su momento la idea fue realmente innovadora.

En resumen, un espejo “mágico” es como cualquier otro espejo, pero le agregarás datos interesantes como un reloj, tu calendario o la previsión meteorológica para los próximos días. Es “mágico” porque es combina un panel de TV con un espejo, conectado a numerosas API para mostrar todo lo que te interesa, nada que ver con el de Harry Potter 🙂

Si estás leyendo esto, estoy seguro de que ya sabes cómo se ve un Magic Mirror, así que vamos a saltar directamente a la parte interesante del contenido.

Instalación del software Magic Mirror en Raspberry Pi

Cubriremos cómo construir el marco para tu espejo mágico, primero, y luego pasaremos a la instalación del software.

Cómo construir un marco para el Magic Mirror

Si planeas construir un Magic Mirror y colgarlo en una de tus paredes en casa, la forma clásica de hacerlo es construir un marco personalizado y luego colocar un televisor y una Raspberry Pi detrás de un vidrio de dos vías (como este en Amazon).

Para ser claros, esta guía no trata de esto. Pero puedo ayudarte con un excelente video que muestra todos los pasos para armar un Magic Mirror con un marco de madera:

Si, como yo, no eres un gran manitas, aún puedes utilizar el software Magic Mirror como un “Magic Dashboard”, sin necesidad del marco ni del espejo. Por ejemplo, podría ser un excelente uso para el RasPad 3 que probé aquí (en inglés). Obtendrás el mismo resultado de una manera mucho más sencilla.

El objetivo principal de este artículo es darte consejos para ahorrar tiempo con la instalación del software, lo que aprenderemos en detalle ahora.

Configurar Magic Mirror en Raspberry Pi

Existen varias formas de instalar el software de un Magic Mirror en tu Raspberry Pi. Permíteme explicarlas brevemente antes de mostrar el ejemplo que recomiendo.

Formas de instalar el software Magic Mirror en Raspberry Pi

En la guía oficial de instalación del Magic Mirror, encontrarás varios métodos para configurarlo en tu Raspberry Pi:

• Magic Mirror OS: Puede parecer la manera más fácil de hacerlo (copiarlo y ya está), pero no es el método que recomiendo.
• Imagen Docker: Docker suele ser una gran solución para instalar nuevos servicios, ya que mantiene todo en un contenedor seguro, protegiendo la aplicación y tu sistema. De nuevo, no es mi método favorito para el Magic Mirror.
• Scripts de instalación aleatorios: Aparentemente son métodos “fáciles”, pero no tienes control sobre lo que se instalará.

Todos estos métodos parecen fáciles al principio, pero descubrí que una vez que los instalé, el mantenimiento se volvió más complicado. Si solo quieres ver rápidamente cómo funciona en un modelo específico de Raspberry Pi o pantalla, adelante, toma la imagen del Magic Mirror OS y cópiala en tu tarjeta SD. Funcionará directamente.

Pero si quieres el mejor método a largo plazo, sigue leyendo esta guía.

Instalación del Magic Mirror

En general, el mejor método para instalar Magic Mirror en una Raspberry Pi es la instalación manual. Después de instalar NodeJS, puedes clonar el repositorio de GitHub e instalar la aplicación con npm.

Aquí están los pasos necesarios para instalar Magic Mirror en tu Raspberry Pi:

• Instalar Raspberry Pi OS con un entorno de escritorio.
  Probablemente funcione en otras distribuciones también, pero solo lo he probado en Raspberry Pi OS.
  Puedes encontrar mi guía de instalación aquí, si la necesitas.
• Descargar e instalar NodeJS:
  curl -sL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install nodejs
  
  Asegúrate de verificar los requisitos para la última versión de Magic Mirror, ya que la versión de NodeJS requerida cambiará con el tiempo. Tengo una guía sobre Node.js en Raspberry Pi (en inglés), si quieres saber más sobre este impresionante lenguaje.
• Una vez hecho esto, clona el repositorio de GitHub para descargar el código fuente de Magic Mirror:
  git clone https://github.com/MagicMirrorOrg/MagicMirror
cd MagicMirror
  
• Finalmente, instala la aplicación con:
  npm install
• Copia el archivo de configuración de muestra:
  cp config/config.js.sample config/config.js
  
  Explicaré todo sobre este archivo en la siguiente sección.
• Y comienza la aplicación:
  npm run start
  
  Eso es todo, deberías ver la pantalla predeterminada de Magic Mirror (fecha, clima, noticias y un cumplido aleatorio).

Ahora estás listo para pasar a la siguiente parte, donde explicaré cómo configurar y personalizar esta pantalla (y arreglar el widget del clima).

Guía de configuración del Magic Mirror

Ahora que has instalado el software para tu espejo mágico, ¿cómo puedes personalizarlo? En esta sección, cubriremos cosas comunes que podrías querer cambiar.

Cómo salir de la pantalla del Magic Mirror

Antes de continuar, hay una cosa que necesitas saber: cómo cerrar la aplicación de Magic Mirror.
Por defecto, se abre en pantalla completa y no muestra una forma obvia de salir.

Para salir de la pantalla del Magic Mirror, presiona “ALT” en tu teclado, el menú superior aparecerá. Luego ve a File > Quit para cerrar la aplicación (o utiliza CTRL+Q).

Si quieres configurar el espejo mágico directamente desde la misma Raspberry Pi, debes cerrar todo antes de continuar.

Nota: Si ALT o CTRL+Q no funcionan en Bookworm, puedes presionar la tecla “Win” (o la tecla de Raspberry Pi en Pi 400) y cerrarlo desde allí.

Cómo funciona la configuración del Magic Mirror

La configuración de Magic Mirror es la que copiaste después de la instalación. La ubicación del archivo probablemente sea algo como: “/home/$USER/MagicMirror/config/config.js”. Ábrelo con tu editor preferido (por ejemplo, nano) y echa un vistazo a los contenidos del archivo.

La estructura del archivo de configuración:

La parte superior del archivo de configuración incluye las variables generales para tu instalación: dirección IP, puerto, idioma y localidad, formato de hora, etc. Estos ajustes serán utilizados por todos los widgets en tu pantalla, así que tómate el tiempo para cambiarlos si es necesario. Por ejemplo, puedes establecer “timeformat” en 12 si lo prefieres y cambiar el idioma a “fr” o cualquier otro idioma.

Entonces, hay un gran bloque con todos los widgets listados. Los widgets se llaman “módulos” en la configuración de Magic Mirror:

La mayoría de los módulos tienen un nombre y una configuración de posición. Por ejemplo, en esta captura de pantalla, podemos ver que por defecto hay un módulo de “reloj” configurado para mostrarse en la parte superior izquierda de la pantalla.

Algunos módulos solo tienen el parámetro de posición para indicar dónde mostrarlo en la pantalla, pero otros módulos pueden tener muchas más opciones. Por ejemplo, el módulo de calendario puede establecer una URL para obtener los próximos días festivos.

Un ejemplo simple: cambia el feed de noticias

Veamos un ejemplo sobre cómo modificar un módulo. En la parte inferior de la pantalla tienes un feed de noticias. Toma los últimos artículos de The New York Times y muestra el título y la fecha de publicación. Quizás estés más interesado en las noticias sobre Raspberry Pi, y puedes editar las opciones del módulo para mostrar los últimos tutoriales de tu página web favorita:

• Abre el archivo de configuración con cualquier editor, por ejemplo:
  nano /home/$USER/MagicMirror/config/config.js
• Encuentra el módulo de noticias:
  
• Cambia el título y URL del feed, con algo como:
  
• Reinicia tu servicio Magic Mirror:
  cd /home/$USER/MagicMirror
npm run start

Eso es todo, ahora verás noticias mucho más interesantes en tu pantalla.

Espero que tengas una mejor comprensión de cómo puedes editar fácilmente el archivo de configuración predeterminado para adaptarlo a tus necesidades. Eres libre de cambiar la configuración, eliminar módulos inútiles o cambiar la posición de los módulos como quieras.

Crear copias se seguridad del archivo de configuración con regularidad probablemente sea una buena idea, en caso de que rompas algo mientras realizas estos cambios.

Acceso remoto al Magic Mirror

Como con la mayoría de los proyectos, encuentro más fácil hacer los cambios en este archivo de configuración desde mi computadora (vía SSH, en inglés). De hecho, existe una forma de ver los resultados en tu navegador en lugar de la pantalla de Raspberry Pi. De esta manera, si tienes una pantalla doble, puedes editar la configuración en una y ver el resultado en la otra.

Si estás interesado en hacer lo mismo, aquí te enseñamos cómo hacerlo:

• Abre el archivo de configuración:
  nano /home/$USER/MagicMirror/config/config.js
• Edita la línea “address”. Puedes poner la dirección IP actual de la Raspberry Pi, o “0.0.0.0” si quieres que funcione incluso si la Raspberry Pi cambia a otra IP en tu red. En mi caso, prefiero la segunda opción, ya que no uso una dirección IP estática:
  address: "0.0.0.0"
• El puerto predeterminado es 8080. Solo necesitas cambiarlo si ya tienes un servicio utilizando este puerto. Si tu configuración de Raspberry Pi está dedicada a este proyecto, puedes mantenerla así.
• Entonces también necesitas cambiar la línea “ipWhitelist” para permitir el acceso remoto desde tu computadora. Al igual que antes, si tu computadora tiene una IP estática, simplemente añádela a la lista. Si no, permite todas las direcciones IP.
  Con una IP estática: ipWhitelist: ["192.168.1.10", "127.0.0.1", "::ffff:127.0.0.1", "::1"]
  
  Permitir todas:
  ipWhitelist: []

Eso debería ser suficiente por ahora. Puedes habilitar HTTPS si quieres, pero necesitarás un certificado, esto no es necesario si solo es para ver tus cambios en tiempo real.

Reinicia la aplicación Magic Mirror y verifica que puedes acceder a ella desde tu computadora, abriendo la URL http://<IP>:8080 en tu navegador. Si no sabes cómo encontrar la dirección IP de tu Raspberry Pi, haz clic en este enlace para leer mi tutorial sobre el tema.

Utilizar esto es más conveniente y también puede ayudar a depurar la mayoría de los problemas, como errores de JavaScript, utilizando las herramientas de desarrollador en tu navegador.

Arregla el widget del tiempo en tu Magic Mirror

Por defecto, hay un widget del tiempo habilitado en la parte superior derecha de la pantalla de Magic Mirror, pero puede que no funcione. Muestra “Loading…” todo el tiempo. Si es así, aquí te explico cómo resolverlo:

• Ve a OpenWeatherMap y crea una cuenta.
• Una vez que hayas iniciado sesión, haz clic en “API keys“ y genera una nueva clave API para tu proyecto Magic Mirror.
• Obtendrás una cadena aleatoria de caracteres. Cópiala.
• Abre el archivo de configuración y encuentra esta parte:
  Coloca tu clave API en ambos lugares. El primero es para el clima actual, el segundo para el pronóstico del tiempo.
• Reinicia tu aplicación Magic Mirror para aplicar los cambios.

El clima de Nueva York debería aparecer en tu pantalla. Para mostrar el clima de otra ubicación, cambia los dos campos “location” y “locationID” para ambos módulos. Puedes encontrar los valores a establecer descargando y extrayendo este archivo.

Este es un archivo grande con todas las ciudades del mundo, por lo que es mejor hacer esto en un terminal o vía SSH:

• Descarga el archivo en la Raspberry Pi:
  wget https://bulk.openweathermap.org/sample/city.list.json.gz
• Extrae el archivo:
  gunzip city.list.json.gz
• Usa grep para encontrar rápidamente el ID correspondiente, algo así debería funcionar:
  grep "Boise" -B1 -A2 city.list.json
• Probablemente obtendrás varios resultados, es por eso que mantengo dos líneas debajo del nombre de la ciudad, para obtener el campo de estado y país.
  Puedes incluso aumentar eso para obtener la longitud y la latitud.

Elige el ID que corresponde a tu ciudad y cambia el valor en el archivo de configuración. Después de reiniciar el Magic Mirror, debería actualizarse con el pronóstico del tiempo correcto.

Cambiar las posiciones de los widgets en tu Magic Mirror

Como habrás visto, cada módulo está configurado para mostrarse en una ubicación específica, pero puede ser complicado entender la lógica detrás de esto. Así que, aquí están las posibles ubicaciones que puedes usar:

• top_bar y bottom_bar: región completa superior e inferior.
• top_left, top_center, y top_right: justo debajo de la barra superior, con tres columnas.
• bottom_left, bottom_center, y bottom_right: encima de la barra inferior, con 3 columnas.
• upper_third, middle_center, y lower_third: estas son las tres regiones en el medio de la pantalla.

Si no está lo suficientemente claro, puedes encontrar una gran explicación visual en los foros de Magic Mirror (aquí).

Iniciar automáticamente Magic Mirror

Si tienes la intención de usar tu Magic Mirror como un dispositivo autónomo, probablemente necesites que se inicie automáticamente cuando la Raspberry Pi se encienda. Esto es especialmente útil si encierras tu Magic Mirror en un marco de madera con vidrio de dos vías.

Para hacerlo, la forma más fácil que encontré es con PM2, un gestor de procesos para las aplicaciones NodeJS. Es un poco como los comandos systemd o service que quizás estés acostumbrado a usar en Linux, pero para procesos NodeJS. Aquí te explico cómo usarlo:

• Instalar PM2 con el comando:
  sudo npm install -g pm2
• Configurar PM2 para que se inicie automáticamente en el arranque:
  pm2 startup
• Crear un script para iniciar la aplicación Magic Mirror:
  nano /home/$USER/mm.sh
• Pegar estas líneas en este archivo:
  cd ./MagicMirror
DISPLAY=:0 npm start
• Guardar y salir (CTRL+X)
• Agregar el permiso de ejecución:
  chmod+x mm.sh
• Iniciar el Magic Mirror con PM2:
  pm2 start mm.sh
• Una vez iniciado, guarda el estado actual con:
  pm2 save
Al hacer esto, se iniciará automáticamente al arrancar.

Una vez hecho, usarás PM2 para administrar la aplicación Magic Mirror. Tienes acceso a comandos útiles como:

• Reiniciar Magic Mirror (después de cualquier cambio de configuración):
  pm2 restart mm
• Cerrar la aplicación:
  pm2 stop mm
Será “start” para reiniciarlo después de eso:
  pm2 start mm.sh
• Mostrar los logs recientes de Magic Mirror:
  pm2 logs mm
  
  Es realmente útil para solucionar cualquier error o si la pantalla no aparece más después de un cambio de configuración.

Instalación de nuevos módulos en tu Magic Mirror

Todo esto ya es bastante bueno, tienes un panel de control ordenado con la fecha/hora, calendario, clima y feed de noticias. Pero esto es solo el comienzo.

Introducción a los módulos Magic Mirror

El Magic Mirror es una aplicación modular, lo que significa que puedes descargar e instalar nuevos widgets de la comunidad. La mayoría de ellos están listados aquí, pero también puedes encontrar módulos de desarrolladores aleatorios en GitHub aquí y allí. Incluye cosas como:

• Mostrar chistes.
• Valores de criptomonedas y acciones en tiempo real.
• Mostrar los horarios semanales para estudiantes.
• Conectarse a la mayoría de las API abiertas como Google apps, empresas de transporte o servicios meteorológicos.

Todo lo que puedas necesitar probablemente ya esté disponible como un módulo para tu tablero. Y si no, puedes crear tus módulos con un poco de JavaScript.

Gestor de módulos de Magic Mirror

Es posible descargar e instalar cada módulo por separado, clonando el proyecto de GitHub para cada uno de ellos, leyendo la documentación y siguiendo los pasos de configuración. Pero me parece un poco complicado y, ya que existe un gestor de módulos, creo que es una buena idea intentar usarlo primero.

El gestor de módulos se llama “mmpm” y se puede instalar en tu Raspberry Pi siguiendo estos pasos:

• Instala los prerrequisitos:
  sudo apt install libffi-dev nginx-full -y
• Luego el paquete en sí:
  python3 -m pip install --upgrade --no-cache-dir mmpm
  
  En Bookworm, necesitas ejecutar este comando en un entorno virtual (como se explica aquí, en inglés).
  
• Ejecuta el instalador:
  mmpm guided-setup
Te hará varias preguntas sobre tu instalación actual y cómo planeas usar el administrador de módulos. No hay respuesta incorrecta. Sigue al asistente y responde todo (la mayoría de las preguntas se responden con “yes” o “no”).
• Una vez que hayas respondido todo, ejecuta los comandos que te proporciona:
  
• Finalmente, ejecuta este comando para agregar el comando mmpm a tu shell:
  echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc && source ~/.bashrc

Una vez hecho esto, puedes usar esta herramienta con los siguientes comandos:

• mmpm search <string>: un motor de búsqueda para encontrar los módulos correspondientes (como apt search).
  mmpm search calendar
• mmpm list: lista todos los paquetes. Hay opciones disponibles para filtrar esta lista, usa –help para verlos.
  mmpm list -a #Listar todo
mmpm list --help #Mostrar la ayuda
mmpm list -i #Listar los módulos instalados
• mmpm install <name>: instala un nuevo paquete.
  mmpm install random_quotes
• mmpm -h: obtén más ayuda acerca de esta herramienta.

Cómo instalar un nuevo módulo de Magic Mirror con mmpm

Para asegurarnos de que todo esté claro, veamos un ejemplo. Digamos que quieres mostrar una frase inspiradora en la pantalla de tu Magic Mirror. Aquí están los pasos sencillos a seguir:

• Busca el nombre de un módulo que haga esto:
  mmpm search quotes
• Hay dos resultados disponibles, tomemos el módulo random_quotes:
  mmpm install random_quotes
  
  
• Una vez hecho esto, lo único que queda por hacer es editar tus archivos de configuración y agregar estas líneas dentro de la sección modules [ ]:
  {
module: "random_quotes",
position: "bottom_bar"
},

• Reinicia el Magic Mirror con:
  pm2 restart mm

Eso es todo, ahora verás una frase aleatoria en la parte inferior de tu pantalla.

La mayoría de los módulos tendrán opciones adicionales que puedes agregar. Por ejemplo, con este puedes establecer qué tipo de citas quieres ver (éxito, inspiración, motivación, etc.). Debes revisar la documentación del módulo para conocer todos los detalles.

Video

Profundizar en el Magic Mirror

Ahora estás listo para instalar el Magic Mirror de la manera correcta en tu Raspberry Pi, incluyendo el administrador de servicios y utilizando mmpm para instalar nuevos módulos. Creo que es un gran proyecto para profundizar en Raspberry Pi; puedes descubrir NodeJS, git y algunos usos de las API populares en el camino.

Obviamente, esta guía es solo una introducción, ya que con este proyecto las posibilidades son infinitas. Déjame saber si experimentas algunos problemas o necesitas otros tutoriales sobre aspectos específicos relacionados con esto (como crear un nuevo módulo), podría probarlo por mi cuenta y eventualmente compartir mis hallazgos en otros artículos.

De todas formas, aquí tienes algunos artículos relacionados que podrían interesarte mientras construyes tu Magic Mirror:

• 7 Formas de Encontrar la Dirección IP de tu Raspberry Pi
• RasPad 3: Reseña Honesta Después de un Mes de Uso (en inglés)
• Reseña de la Pantalla Táctil Raspberry Pi 10.1″ (Con Fotos) (en inglés)
• Los 25 Mejores Proyectos Caseros con Raspberry Pi en 2025