Magic Mirror sur Raspberry Pi : Guide d’Installation Complet

J’ai toujours été fasciné par l’idée d’avoir mon propre miroir connecté, alors j’ai finalement essayé le projet Magic Mirror avec un Raspberry Pi. Mais la plupart des guides rendent les choses plus compliquées qu’elles ne le sont en réalité. J’ai donc décidé de créer une version simple et accessible pour les débutants. Laissez-moi vous guider !

MagicMirror peut être installé sur Raspberry Pi en utilisant une configuration manuelle avec Node.js ou un script automatique. La méthode la plus simple est d’utiliser l’installateur officiel, qui télécharge toutes les dépendances et configure le système automatiquement.

Dans ce guide, je vais présenter rapidement MagicMirror, puis je vous montrerai la meilleure façon de l’installer sur Raspberry Pi. Nous passerons en revue les astuces de configuration, le management des modules et les petites modifications pour améliorer l’expérience globale. N’hésitez pas à aller directement aux parties qui vous intéressent.

Si vous débutez avec Raspberry Pi ou Linux, j’ai quelque chose qui peut vous aider !
Téléchargez ma fiche mémo des commandes Linux gratuitement – c’est un guide de référence rapide avec toutes les commandes essentielles dont vous aurez besoin utiliser votre Raspberry Pi. Cliquez ici pour l’obtenir gratuitement !

Présentation du projet Magic Mirror

De la même façon que jouer à des jeux classiques sur Retropie ou regarder Netflix avec Kodi, réaliser un Magic Mirror est un projet qui a contribué à populariser le Raspberry Pi. C’est un tel bonheur une fois terminé et son aspect futuriste a suscité l’intérêt de nombreux créateurs.

Michael Teeuw est l’inventeur original du projet Magic Mirror, et vous pouvez trouver de nombreuses ressources à ce sujet sur son site web. Comme nous le verrons plus tard, construire un Magic Mirror n’est pas aussi compliqué que vous pourriez le penser, mais l’idée était vraiment novatrice à l’époque.

En bref, un « miroir magique », c’est un miroir classique, mais vous y ajouterez des informations intéressantes, comme une horloge, votre agenda ou les prévisions météorologiques pour les prochains jours. Il est « magique » car c’est un mélange entre un tableau de bord de télévision et un miroir, connecté à de nombreuses API pour afficher tout ce qui vous intéresse, rien à voir avec celui de Harry Potter 🙂

Si vous lisez ceci, je suis sûr que vous savez déjà à quoi ressemble un Magic Mirror, alors passons directement à la partie intéressante du contenu.

Installer le logiciel Magic Mirror sur Raspberry Pi

Commençons par voir comment construire le cadre de votre miroir magique, puis nous passerons à l’installation du logiciel.

Comment construire un cadre pour Magic Mirror

Si vous prévoyez de construire un Magic Mirror et de l’accrocher sur l’un de vos murs à la maison, la méthode classique consiste à construire un cadre sur mesure, puis à placer une télévision et un Raspberry Pi derrière un verre double face (comme celui-ci sur Amazon).

Pour être clair, il ne s’agit pas de cela ici. Mais je peux vous aider avec une superbe vidéo qui vous montre toutes les étapes pour construire un Miroir Magique avec un cadre en bois :

Si, comme moi, vous n’êtes pas un grand bricoleur, vous pouvez toujours utiliser le logiciel du Miroir Magique comme un tableau de bord magique, sans cadre ni miroir. Par exemple, cela pourrait être une excellente utilisation de la RasPad 3 que j’ai testée ici. Vous obtiendrez le même résultat de manière beaucoup plus simple.

Le principal objectif de cet article est de vous donner des conseils pour gagner du temps avec l’installation du logiciel, que nous allons maintenant apprendre en détail.

Installer Magic Mirror sur Raspberry Pi

Il existe plusieurs façons de mettre le logiciel d’un miroir magique sur votre Raspberry Pi. Laissez-moi brièvement évoquer celles-ci avant de donner l’exemple que je recommande.

Moyens d’installer le logiciel Magic Mirror sur Raspberry Pi

Dans le guide d’installation officiel du Magic Mirror, vous trouverez plusieurs méthodes pour l’installer sur votre Raspberry Pi :

• Magic Mirror OS : Cela peut sembler être la façon la plus facile (le flasher, et c’est fait), mais ce n’est pas la méthode que je recommande.
• Image Docker : Docker est souvent une excellente solution pour installer de nouveaux services, car il garde tout dans un conteneur sûr, protégeant l’application et votre système. Encore une fois, ce n’est pas ma méthode préférée pour le Magic Mirror.
• Scripts d’installation quelconques : Ce sont généralement des méthodes qui semblent « faciles » en surface, mais vous n’avez aucun contrôle sur ce qui sera installé.

Toutes ces méthodes semblent faciles au début, mais j’ai trouvé qu’une fois installées, la maintenance devenait plus compliquée. Si vous voulez simplement vérifier rapidement comment il fonctionne sur un modèle ou un écran Raspberry Pi spécifique, allez-y, prenez l’image Magic Mirror OS et flashez-la sur votre carte SD. Ça marchera directement.

Mais si vous voulez la meilleure méthode à long terme, continuez à lire ce guide.

Installation de Magic Mirror

En général, la meilleure méthode pour installer Magic Mirror sur un Raspberry Pi est l’installation manuelle. Après avoir installé NodeJS, vous pouvez cloner le répertoire GitHub et installer l’application avec npm.

Voici les étapes requises pour installer Magic Mirror sur votre Raspberry Pi :

• Installez Raspberry Pi OS avec un environnement de bureau.
  Cela devrait probablement fonctionner sur d’autres distributions aussi, mais je ne l’ai testé que sur Raspberry Pi OS.
  Vous pouvez trouver mon guide d’installation ici si besoin.
• Téléchargez et installez NodeJS :
  curl -sL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install nodejs
  
  Assurez-vous de vérifier les exigences pour la dernière version de Magic Mirror, car la version de NodeJS requise changera avec le temps. J’ai un guide sur Node.js sur Raspberry Pi si vous voulez en savoir plus sur ce langage cool.
• Une fois fait, clonez le dépôt GitHub pour télécharger le code source du Magic Mirror :
  git clone https://github.com/MagicMirrorOrg/MagicMirror
cd MagicMirror
  
• Enfin, installez l’application avec :
  npm install
• Copiez le fichier de configuration d’exemple :
  cp config/config.js.sample config/config.js
  Je vous expliquerai tout sur ce fichier dans la prochaine section.
• Et démarrez l’application :
  npm run start

Voilà, vous devriez avoir l’affichage par défaut du Magic Mirror sur votre écran (date, météo, nouvelles et un compliment aléatoire).

Vous êtes maintenant prêt à passer à la partie suivante, où je vous expliquerai comment configurer et personnaliser cet écran (et réparer le widget météo).

Si les commandes Linux ce n’est pas trop votre truc, n’hésitez pas à jeter un œil à cet article qui vous explique les commandes qu’il faut absolument connaître. Je vous donne aussi une antisèche à télécharger pour les avoir toujours sous la main !

Guide de configuration du Magic Mirror

Maintenant que vous avez installé le logiciel pour votre Magic Mirror, comment le personnaliser ? Dans cette section, nous allons couvrir les choses communes que vous pourriez vouloir changer.

Comment sortir de l’écran Magic Mirror

Avant d’aller plus loin, il y a une chose que vous devez savoir : comment fermer l’application Magic Mirror.
Par défaut, elle s’ouvre en plein écran et ne montre pas de moyen évident pour sortir.

Pour sortir de l’écran Magic Mirror, appuyez sur « ALT » de votre clavier, le menu en haut apparaîtra. Puis allez à File > Quitter pour fermer l’application (ou utilisez CTRL+Q).

Si vous voulez configurer le Magic Mirror directement depuis le même Raspberry Pi, vous devez tout fermer avant de continuer.

Remarque : Si ALT ou CTRL+Q ne fonctionne pas sur Bookworm, vous pouvez appuyer sur la touche « Win » (ou la touche Raspberry Pi sur Pi 400) et le fermer à partir de là.

Comment fonctionne la configuration du Magic Mirror

La configuration de Magic Mirror est celle que vous avez copiée après l’installation. L’emplacement du fichier ressemble probablement à celui-ci : « /home/$USER/MagicMirror/config/config.js ». Ouvrez-le avec votre éditeur préféré (nano par exemple), et regardez le contenu du fichier.

La structure du fichier de configuration :

Le haut du fichier de configuration inclut les variables générales pour votre installation : adresse IP, port, langue et localisation, format de l’heure, etc. Ces paramètres seront utilisés par tous les widgets sur votre écran, donc prenez le temps de les modifier si nécessaire. Par exemple, vous pouvez régler « timeformat » sur 12 si vous préférez et changer la langue en « fr » ou n’importe quelle autre langue que vous préférez.

Ensuite, il y a un gros bloc avec tous les widgets listés. Les widgets sont nommés « modules » dans la configuration du Magic Mirror :

La plupart des modules ont un nom et un réglage de position. Par exemple, sur cette capture d’écran, nous voyons qu’il y a par défaut un module « horloge » configuré pour s’afficher en haut à gauche de l’écran.

Certains modules ont seulement un paramètre de position pour indiquer où les afficher à l’écran, mais d’autres modules peuvent avoir beaucoup plus d’options. Par exemple, le module agenda peut définir une URL pour chercher les prochains jours fériés.

Un exemple simple : changer le fil d’actualités.

Prenons un exemple pour voir comment modifier un module. Au bas de l’écran, vous avez un fil d’actualités. Il récupère les derniers articles du New York Times et affiche le titre et la date de publication. Mais vous voudrez peut-être afficher plutôt les actualités du Raspberry Pi, et pouvez modifier les options des modules pour afficher les derniers tutoriels de votre site préféré :

• Ouvrez le fichier de configuration avec n’importe quel éditeur, par exemple :
  nano /home/$USER/MagicMirror/config/config.js
• Trouvez le module de flux de nouvelles :
  
• Changez le titre et l’URL du flux, avec quelque chose comme :
  
• Redémarrez votre service Magic Mirror :
  cd /home/$USER/MagicMirror
npm run start

Voilà, vous verrez maintenant des actualités beaucoup plus intéressantes sur votre écran.

J’espère que vous avez une meilleure compréhension de la façon dont vous pouvez facilement modifier le fichier de configuration par défaut pour répondre à vos besoins. Vous êtes libre de changer les paramètres, de supprimer les modules inutiles ou de changer la position des modules comme vous le souhaitez.

Faire des sauvegardes régulières du fichier de configuration est probablement une bonne idée, au cas où vous casseriez quelque chose en faisant ces changements.

Accès à distance au Magic Mirror

Comme pour la plupart des projets, je trouve plus facile de modifier le fichier de configuration depuis mon ordinateur (via SSH). De plus, il existe un moyen de voir les résultats dans votre navigateur plutôt que sur l’écran du Raspberry Pi. De cette façon, si vous avez deux écrans, vous pouvez modifier la configuration sur l’un et voir le résultat sur l’autre.

Si vous voulez faire la même chose, voici comment faire :

• Ouvrez le fichier de configuration :
  nano /home/$USER/MagicMirror/config/config.js
• Modifiez la ligne « address ». Vous pouvez soit mettre l’adresse IP actuelle du Raspberry Pi, soit « 0.0.0.0 » si vous voulez que cela fonctionne même si le Raspberry Pi passe à une autre IP sur votre réseau. Dans mon cas, je préfère la deuxième option, car je n’utilise pas d’adresse IP statique :
  address: "0.0.0.0"
• Le port par défaut est 8080. Vous n’avez besoin de le modifier que si vous avez déjà un service qui l’utilise. Si votre configuration Raspberry Pi est dédiée à ce projet, vous pouvez le laisser tel quel.
• Ensuite, vous devez également changer la ligne « ipWhitelist » pour permettre à votre ordinateur d’accéder à distance. Même chose ici, si votre ordinateur a une IP statique, ajoutez-la simplement à la liste. Sinon, autorisez toutes les adresses IP.
  Avec une IP statique : ipWhitelist: ["192.168.1.10", "127.0.0.1", "::ffff:127.0.0.1", "::1"]
  Permettre à tous : ipWhitelist: []

Cela devrait suffire pour le moment. Vous pouvez activer HTTPS si vous le voulez, mais vous aurez besoin d’un certificat, ce qui n’est pas nécessaire si c’est juste pour voir vos modifications en temps réel.

Redémarrez l’application Magic Mirror et vérifiez que vous pouvez y accéder depuis votre ordinateur en ouvrant l’URL http://<IP>:8080 dans votre navigateur. Si vous ne savez pas comment trouver l’adresse IP de votre Raspberry Pi, cliquez sur ce lien pour lire mon tutoriel sur le sujet.

Utiliser cela est plus pratique et peut également aider à déboguer la plupart des problèmes, comme les erreurs JavaScript, en utilisant les outils de développement dans votre navigateur.

Réparer le widget Météo sur votre Magic Mirror

Par défaut, un widget météo est activé en haut à droite de l’écran du Magic Mirror, mais il peut ne pas fonctionner. Il affiche « Chargement… » tout le temps. Si c’est le cas, voici comment le réparer :

• Allez sur OpenWeatherMap et créez un compte.
• Une fois connecté, cliquez sur « API keys » et générez une nouvelle clé API pour votre projet Magic Mirror.
• Vous recevrez une chaîne de caractères aléatoires. Copiez-la.
• Ouvrez le fichier de configuration et trouvez cette partie :
  
  Mettez votre clé API dans les deux emplacements. La première est pour la météo actuelle, la seconde pour les prévisions météo.
• Redémarrez votre application Magic Mirror pour appliquer les modifications.

La météo de New York devrait maintenant être affichée sur votre écran. Pour afficher la météo d’un autre endroit, changez les deux champs « location » et « locationID » pour les deux modules. Vous pouvez trouver les valeurs à définir en téléchargeant et extrayant ce fichier.

Ce fichier est volumineux car il contient toutes les villes du monde, il est donc préférable de le faire dans un terminal ou via SSH :

• Téléchargez le fichier sur le Raspberry Pi :
  wget https://bulk.openweathermap.org/sample/city.list.json.gz
• Extrayez le fichier :
  gunzip city.list.json.gz
• Utilisez grep pour trouver rapidement l’ID correspondant, quelque chose comme cela devrait marcher :
  grep "Boise" -B1 -A2 city.list.json
• Vous obtiendrez probablement plusieurs résultats, c’est pourquoi je garde deux lignes sous le nom de la ville, pour obtenir le champ de l’état et du pays.
  Vous pouvez même augmenter cela pour obtenir la longitude et la latitude.

Choisissez l’ID correspondant à votre ville et changez la valeur dans le fichier de configuration. Après avoir redémarré le Magic Mirror, il devrait être mis à jour avec la bonne prévision météo.

Changer la position des widgets sur le Magic Mirror

Comme vous l’avez vu, chaque module est réglé pour s’afficher à un endroit spécifique, mais il peut être compliqué de comprendre la logique utilisée. Voici donc les emplacements possibles que vous pouvez utiliser :

• top_bar et bottom_bar : bande supérieure et inférieure en pleine largeur.
• top_left, top_center et top_right : juste sous la barre supérieure, avec trois colonnes.
• bottom_left, bottom_center et bottom_right : au-dessus de la barre inférieure, avec 3 colonnes.
• upper_third, middle_center et lower_third : ce sont les trois régions situées au milieu de l’écran.

Si ce n’est pas assez clair, vous pouvez trouver une excellente explication visuelle sur les forums de Magic Mirror (ici).

Démarrage automatique du Magic Mirror

Si vous envisagez d’utiliser votre Magic Mirror comme un appareil autonome, vous aurez probablement besoin qu’il se lance automatiquement lorsque le Raspberry Pi démarre. C’est particulièrement utile si vous enfermez votre Magic Mirror dans un cadre en bois avec un verre sans tain.

Pour ce faire, la façon la plus simple que j’ai trouvé est d’utiliser PM2. PM2 est un gestionnaire de processus pour une application NodeJS. C’est un peu comme les commandes systemd ou service auxquelles vous avez peut-être l’habitude sur Linux, mais pour les processus NodeJS. Voici comment l’utiliser :

• Installez PM2 avec cette commande :
  sudo npm install -g pm2
• Réglez PM2 pour démarrer automatiquement au boot :
  pm2 startup
• Créez un script pour démarrer l’application Magic Mirror :
  nano /home/$USER/mm.sh
• Collez ces lignes dans ce fichier :
  cd ./MagicMirror
DISPLAY=:0 npm start
• Enregistrez et quittez (CTRL+X)
• Ajoutez la permission d’exécution :
  chmod+x mm.sh
• Démarrez le Magic Mirror avec PM2 :
  pm2 start mm.sh
• Une fois démarré, enregistrez l’état actuel avec :
  pm2 save
En faisant cela, il démarrera automatiquement au démarrage.

Une fois terminé, vous allez maintenant utiliser PM2 pour gérer l’application Magic Mirror. Vous aurez accès à des commandes pratiques comme :

• Redémarrer Magic Mirror (après tout changement de configuration) :
  pm2 restart mm
• Fermer l’application :
  pm2 stop mm
Pour la redémarrer par la suite, utilisez :
  pm2 start mm.sh
• Afficher les journaux récents de Magic Mirror :
  pm2 logs mm
  C’est très utile pour dépanner toute erreur ou si l’écran ne s’affiche plus après un changement de configuration.

Installer de nouveaux modules sur votre Magic Mirror

Tout cela est déjà assez sympa, vous avez un tableau de bord net avec la date/l’heure, un agenda, la météo et les actualités. Mais ce n’est que le début.

Présentation des modules Magic Mirror

Le Magic Mirror est une application modulaire, ce qui signifie que vous pouvez télécharger et installer de nouveaux widgets de la communauté. La plupart d’entre eux sont listés ici, mais vous pouvez aussi trouver des modules de développeurs quelconques sur GitHub, comme par exemple :

• Affichage des blagues.
• Valeurs des cryptomonnaies et des actions en temps réel.
• Affichage des horaires hebdomadaires pour les étudiants.
• Connexion à la plupart des API ouvertes comme les applications Google, les compagnies de transport ou les services météo.

Tout ce dont vous pourriez avoir besoin est probablement déjà disponible sous forme de module pour votre tableau de bord. Et sinon, vous pouvez créer vos propres modules avec un peu de JavaScript.

Gestionnaire de modules Magic Mirror

Il est possible de télécharger et d’installer chaque module séparément en clonant le projet GitHub pour chacun d’entre eux, en lisant la documentation et en suivant les étapes de configuration. Mais je trouve ça un peu compliqué, et puisqu’un gestionnaire de modules existe, je pense que c’est une bonne idée d’essayer de l’utiliser en premier.

Le gestionnaire de modules se nomme « mmpm » et peut être installé sur votre Raspberry Pi en suivant ces étapes :

• Installez les prérequis :
  sudo apt install libffi-dev nginx-full -y
• Ensuite, le paquet lui-même :
  python3 -m pip install --upgrade --no-cache-dir mmpm
  Sur Bookworm, vous devez faire cette commande dans un environnement virtuel (explication ici).
  
• Exécutez l’installateur :
  mmpm guided-setup
Il vous posera plusieurs questions sur votre installation actuelle et comment vous prévoyez d’utiliser le gestionnaire de modules. Il n’y a pas de mauvaise réponse. Suivez l’assistant et répondez à tout (la plupart des questions sont répondues par « yes » ou « no »).
• Une fois que vous avez répondu à tout, exécutez les commandes qu’il vous donne :
  
• Enfin, exécutez cette commande pour ajouter la commande mmpm à votre shell :
  echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc && source ~/.bashrc

Une fois terminé, vous pouvez utiliser cet outil avec les commandes suivantes :

• mmpm search <chaîne de caractères> : Un moteur de recherche pour trouver des modules correspondants (comme apt search).
  mmpm search calendar
• mmpm list : Liste tous les paquets. Des options sont disponibles pour filtrer cette liste, utilisez –help pour les voir.
  mmpm list -a #Liste tout
mmpm list --help #Montre l'aide
mmpm list -i #Liste les modules installés
• mmpm install <nom> : Installe un nouveau paquet.
  mmpm install random_quotes
• mmpm -h : Obtenez plus d’aide sur cet outil.

Comment installer un nouveau module Magic Mirror avec mmpm

Pour être sûr que tout est clair, prenons un exemple. Disons que vous voulez afficher une citation inspirante sur l’écran de votre Magic Mirror. Voici les étapes faciles à suivre pour le faire :

• Cherchez le nom d’un module qui propose cette fonction :
  mmpm search quotes
• Il y a deux résultats disponibles, prenons le module random_quotes :
  mmpm install random_quotes
  
• Une fois fait, la seule chose à faire est de modifier vos fichiers de configuration, et ajoutez ces lignes dans la section modules [ ] :
  {
module: "random_quotes",
position: "bottom_bar"
},

• Redémarrez le Magic Mirror avec :
  pm2 restart mm

Voilà, vous obtiendrez maintenant une citation aléatoire en bas de votre écran.

La plupart des modules auront des options supplémentaires que vous pouvez ajouter. Par exemple, avec celui-ci, vous pouvez définir le type de citations que vous souhaitez voir (succès, inspiration, motivation, etc.). Vous devez consulter la documentation du module pour connaître tous les détails.

Vidéo

Aller plus loin avec le Magic Mirror

Vous êtes maintenant prêt à installer Magic Mirror de la bonne manière sur votre Raspberry Pi, y compris le gestionnaire de services et à utiliser mmpm pour installer de nouveaux modules. Je pense que c’est un projet génial pour aller plus loin avec un Raspberry Pi, vous pourriez découvrir NodeJS, git et certaines utilisations d’API populaires en cours de route.

Évidemment, ce guide n’est qu’une introduction, car les possibilités sont infinies avec ce projet. Faites-moi savoir si vous rencontrez des problèmes ou si vous avez besoin d’autres tutoriels sur des aspects spécifiques de ce projet (comme la création d’un nouveau module), je pourrais essayer de mon côté et éventuellement partager mes découvertes dans d’autres articles.

Quoi qu’il en soit, voici quelques articles associés qui pourraient vous intéresser pendant la construction de votre Miroir Magique :

• 6 projets Raspberry Pi qui ont fait le buzz (Essayez-les vous-même !)
• Comment trouver l’adresse IP actuelle d’un Raspberry Pi ?
• RasPad 3 : Revue honnête après un mois d’utilisation
• Revue de l’écran tactile 10.1″ Raspberry Pi (Avec photos)
• 25 idées géniales de projets Raspberry Pi à réaliser à la maison

Ressources supplémentaires pour votre Raspberry Pi

Initiation au Raspberry Pi en vidéo
Si vous débutez et voulez passer rapidement à la vitesse supérieure, j’ai exactement ce qu’il vous faut.
Regardez ma formation vidéo qui vous aidera à démarrer du bon bien, choisir votre matériel, installer les meilleures applications et vous lancer directement dans vos premiers projets avec mon aide.
Regarder les vidéos dès maintenant

Maîtrisez votre Raspberry Pi en 30 jours
Vous avez besoin de plus ? Si vous êtes à la recherche des meilleures astuces pour devenir expert sur Raspberry Pi, ce livre est fait pour vous. Développez vos compétences sous Linux et pratiquez via de nombreux projets en suivant mes guides étape par étape. 10% de remise aujourd’hui !
Télécharger le livre au format PDF ici

Maîtrisez Python sur Raspberry Pi
Pas besoin d’être un génie pour coder quelques lignes pour votre Raspberry Pi.
Je vous apprends juste ce qu’il faut sur Python afin de réaliser n’importe quel projet. La seconde partie du livre est d’ailleurs consacrée à des exemples de projets où je vous guide pas à pas.
Ne perdez pas de temps, apprenez le strict nécessaire et économisez 10% avec ce lien :
Télécharger maintenant

Autres ressources pour profiter de votre Raspberry Pi
J’ai regroupé toutes mes recommandations de logiciels, sites utiles et de matériel sur cette page de ressources. Je vous invite à la consulter régulièrement pour faire les bons choix et rester à jour.
Visiter les pages ressources