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 :
# 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
- Vérifiez si
Gitest installé sur votre machine en exécutant la commandegit(l'aide devrait s'afficher), sinon installez-le.
sudo apt update sudo apt install git -yVérifier
git --version(Cela devrait vous afficher quelque chose comme
git version 2.30.xou plus récent). -
Cloner le dépôt :
git clone https://github.com/MagicMirrorOrg/MagicMirror -
Accédez au dépôt :
cd MagicMirror -
Installez l'application : ``
node --run install-mm - Faites une copie du fichier de configuration d'exemple :
cp config/config.js.sample config/config.js -
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²
ToPour makegarantir surele theredémarrage de MagicMirror² restartsaprès afterun rebooting,redémarrage, youvous needdevez toenregistrer savel'état theactuel currentde statetous of allles scripts runningexécutés via PM2. ToPour doce this,faire, executeexécutez thela followingcommande commandsuivante :
pm2 save
Et voilà ! Votre MagicMirror² devrait maintenant redémarrer après le démarrage et après toute panne.