Installation sur un Raspberry Pi

Prérequis

Raspberry Pi OS

Vous devrez installer la dernière version complète du système d'exploitation Raspberry Pi OS 
Utilisez l'application Raspberry Pi Imager

Node.js

Node.js est le framework requis pour exécuter MagicMirror.
L'installation de Node.js est très simple ; suivez simplement le guide officiel ci-dessous :

👉🏻 nodejs download current

# Download and install nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash

# in lieu of restarting the shell
\. "$HOME/.nvm/nvm.sh"

# Download and install Node.js:
nvm install 25

# Verify the Node.js version:
node -v # Should print "v25.2.1".

# Verify npm version:
npm -v # Should print "11.6.2".

Installation manuelle

1. Vérifiez si Git est installé sur votre machine en exécutant la commande git (l'aide devrait s'afficher), sinon installez-le.
   

   sudo apt update
   sudo apt install git -y

   Vérifier

   git --version

   (Cela devrait vous afficher quelque chose comme git version 2.30.x ou plus récent).
   
   

2. Cloner le dépôt :
   

   git clone https://github.com/MagicMirrorOrg/MagicMirror

3. Accédez au dépôt :
   

   cd MagicMirror

4. Installez l'application : ``
   

   node --run install-mm

5. Faites une copie du fichier de configuration d'exemple :
   

   cp config/config.js.sample config/config.js

6. Lancer l'application :
   

   node --run start

    

Démarrage automatique de votre MagicMirror

Utilisation de PM2

PM2 est un gestionnaire de processus de production pour les applications Node.js, doté d'un équilibreur de charge intégré. Il permet de maintenir les applications actives en permanence, de les recharger sans interruption de service et de simplifier les tâches d'administration système courantes. Dans cet exemple, nous l'utiliserons pour exécuter un script shell.

Install PM2

npm install -g pm2

Démarrage de PM2 au boot

Pour que PM2 puisse fonctionner correctement lors du (re)démarrage de votre système d'exploitation, il doit être lancé au démarrage. Heureusement, PM2 dispose d'une fonction pratique pour cela.

pm2 startup

PM2 va maintenant vous afficher une commande à exécuter.

Créer un script de démarrage MagicMirror²

Pour utiliser PM2 avec MagicMirror², il suffit de créer un simple script shell. Il est préférable de placer ce script en dehors du dossier MagicMirror² afin d'éviter tout problème lors d'une éventuelle mise à jour du miroir.

cd ~
nano mm.sh

cd ./MagicMirror
DISPLAY=:0 node --run start

Enregistrez et fermez le fichier à l'aide des commandes CTRL+O et CTRL+X. Assurez-vous ensuite que le script shell est exécutable en exécutant la commande suivante :

chmod +x mm.sh

Démarrez votre MagicMirror² avec PM2

pm2 start mm.sh

Votre miroir devrait maintenant démarrer et apparaître sur votre écran après quelques secondes.

Activer le redémarrage du script MagicMirror²

To make sure the MagicMirror² restarts after rebooting, you need to save the current state of all scripts running via PM2. To do this, execute the following command