secubox-openwrt/package/secubox/luci-app-magicmirror2/README.fr.md

MagicMirror2 Manager pour SecuBox

English | Francais | 中文

Ecosysteme complet pour executer et gerer MagicMirror2 sur les systemes SecuBox bases sur OpenWrt.

Vue d'ensemble

Ce package fournit une implementation complete de MagicMirror2 incluant :

• MagicMirror2 base sur Docker : installation et gestion
• Interface Web LuCI pour la gestion des modules et la configuration
• Gestionnaire de modules - Installer, mettre a jour et supprimer des modules MM2 depuis l'interface web
• Editeur de configuration - Editer config.js avec coloration syntaxique et exemples
• Integration VHost - Publier votre miroir via reverse proxy avec SSL
• Outils CLI - Controle en ligne de commande pour les utilisateurs avances

Composants

1. secubox-app-magicmirror

Package OpenWrt fournissant l'installation MagicMirror2 basee sur Docker.

Emplacement : package/secubox/secubox-app-magicmirror/

Fichiers :

• Makefile - Definition du package
• files/etc/config/magicmirror - Configuration UCI
• files/etc/init.d/magicmirror - Script d'initialisation
• files/usr/sbin/magicmirrorctl - Script de controle avec gestion des modules

Fonctionnalites :

• Gestion automatisee des images Docker
• Montages de volumes pour config, modules et CSS
• Gestion des modules en CLI (installer/supprimer/mettre a jour)
• Gestion de la configuration (afficher/editer/sauvegarder/restaurer)

2. luci-app-magicmirror

Application web LuCI pour gerer les modules et la configuration MagicMirror2.

Emplacement : package/secubox/luci-app-magicmirror/

Vues :

• Vue d'ensemble (overview.js) - Tableau de bord, controle du service, parametres de base
• Modules (modules.js) - Gestionnaire de modules avec installer/mettre a jour/supprimer
• Configuration (config.js) - Editeur de configuration avec validation et modeles

Backend RPCD : /usr/libexec/rpcd/luci.magicmirror

• getStatus - Statut du service et statistiques
• listModules - Lister les modules installes
• getConfig - Obtenir le contenu de la configuration
• installModule - Installer un module depuis une URL Git
• removeModule - Supprimer un module installe
• updateModule - Mettre a jour un module vers la derniere version
• getModuleConfig - Obtenir le README/config du module
• saveConfig - Sauvegarder les modifications de configuration
• restartService - Redemarrer le service MagicMirror

3. Integration Appstore

Entree dans : luci-app-secubox/appstore/apps.json

{
  "id": "secubox-app-magicmirror",
  "name": "MagicMirror2",
  "version": "2.28.0",
  "category": "iot",
  "description": "Plateforme miroir intelligent...",
  "luci_app": "luci-app-magicmirror"
}

4. Modele VHost

Emplacement : luci-app-vhost-manager/htdocs/luci-static/resources/vhost-manager/templates.json

{
  "id": "magicmirror",
  "domain": "mirror.local",
  "backend": "http://127.0.0.1:8080",
  "port": 8080,
  "app_id": "secubox-app-magicmirror",
  "websocket_support": true
}

5. Manifeste du plugin

Emplacement : secubox-app/files/usr/share/secubox/plugins/catalog/magicmirror.json

Definit les metadonnees du package, les prerequis, les capacites et les etapes de l'assistant.

Installation

Installation rapide

# Compiler tous les packages
make package/secubox-app-magicmirror/compile
make package/luci-app-magicmirror/compile

# Installer sur le routeur
opkg install secubox-app-magicmirror_*.ipk
opkg install luci-app-magicmirror_*.ipk

# Installer et demarrer
magicmirrorctl install
/etc/init.d/magicmirror enable
/etc/init.d/magicmirror start

Via l'Appstore SecuBox

1. Naviguer vers SecuBox -> Appstore
2. Trouver MagicMirror2 dans la categorie IoT
3. Cliquer sur Installer
4. Configurer via SecuBox -> IoT -> MagicMirror2

Utilisation

Interface Web

Naviguer vers : SecuBox -> IoT -> MagicMirror2

Onglet Vue d'ensemble

• Voir le statut et les statistiques du service
• Demarrer/arreter/redemarrer le service
• Configurer les parametres de base (port, fuseau horaire, langue, unites)
• Acces rapide a l'interface web du miroir

Onglet Modules

• Voir tous les modules installes
• Installer de nouveaux modules depuis des URLs Git
• Mettre a jour les modules vers les dernieres versions
• Supprimer des modules
• Voir les informations et le README des modules

Installer un module :

1. Cliquer sur Installer un nouveau module
2. Entrer l'URL Git (ex. https://github.com/MichMich/MMM-WeatherChart)
3. Cliquer sur Installer
4. Attendre la fin de l'installation (peut prendre quelques minutes)

Onglet Configuration

• Editer config.js dans l'editeur web
• Validation de la syntaxe
• Diagramme de reference des positions des modules
• Exemples de configurations
• Option de sauvegarde et redemarrage automatique

Ligne de commande

# Gestion du service
magicmirrorctl install      # Installer et configurer
magicmirrorctl status       # Afficher le statut du conteneur
magicmirrorctl logs         # Voir les logs
magicmirrorctl update       # Mettre a jour vers la derniere image

# Gestion des modules
magicmirrorctl module list  # Lister les modules installes
magicmirrorctl module install <git-url>
magicmirrorctl module update <nom-module>
magicmirrorctl module remove <nom-module>
magicmirrorctl module config <nom-module>  # Afficher la config

# Gestion de la configuration
magicmirrorctl config show    # Afficher la config actuelle
magicmirrorctl config edit    # Editer dans vi
magicmirrorctl config backup  # Sauvegarder la config actuelle
magicmirrorctl config restore # Restaurer depuis la sauvegarde
magicmirrorctl config reset   # Reinitialiser aux valeurs par defaut

Configuration VHost

1. Activer MagicMirror dans le gestionnaire VHost :

   • Aller dans Gestionnaire VHost -> Services internes
   • Trouver MagicMirror2
   • Cliquer sur Creer
   • Configurer le domaine (ex. mirror.local)
   • Activer SSL si desire

2. Acceder via le domaine :

   • http://mirror.local (ou votre domaine configure)
   • Network Tweaks gere automatiquement la resolution DNS

Configuration

Config UCI : /etc/config/magicmirror

config magicmirror 'main'
	option enabled '1'
	option image 'karsten13/magicmirror:latest'
	option config_path '/srv/magicmirror/config'
	option modules_path '/srv/magicmirror/modules'
	option css_path '/srv/magicmirror/css'
	option port '8080'
	option timezone 'UTC'
	option language 'en'
	option units 'metric'

Structure config.js

Situe dans : /srv/magicmirror/config/config.js

let config = {
	address: "0.0.0.0",
	port: 8080,
	language: "en",
	timeFormat: 24,
	units: "metric",

	modules: [
		{
			module: "clock",
			position: "top_left"
		},
		{
			module: "weather",
			position: "top_right",
			config: {
				weatherProvider: "openweathermap",
				type: "current",
				location: "Paris",
				apiKey: "VOTRE_CLE_API"
			}
		}
		// Ajouter plus de modules ici
	]
};

Positions des modules

+==================================================+
|                   top_bar                        |
+==============+==============+====================+
|  top_left    |  top_center  |    top_right       |
+==============+==============+====================+
| upper_third  |middle_center |   upper_third      |
+==============+==============+====================+
| lower_third  |              |   lower_third      |
+==============+==============+====================+
| bottom_left  |bottom_center |   bottom_right     |
+==============+==============+====================+
|                  bottom_bar                      |
+==================================================+

Modules populaires

• MMM-WeatherChart - Graphiques de previsions meteo
• MMM-MyCalendar - Affichage de calendrier ameliore
• MMM-NOAA - Donnees meteo NOAA
• MMM-Facial-Recognition - Reconnaissance faciale
• MMM-Cryptocurrency - Suivi des prix crypto
• MMM-Todoist - Gestionnaire de taches Todoist
• MMM-Spotify - En cours de lecture Spotify
• MMM-GooglePhotos - Diaporama Google Photos

Parcourir tous les modules

Depannage

Miroir non accessible

1. Verifier le statut du service : magicmirrorctl status
2. Voir les logs : magicmirrorctl logs -f
3. Verifier le port : uci get magicmirror.main.port
4. Verifier Docker : /etc/init.d/dockerd status

Echec d'installation de module

1. S'assurer que git est installe : opkg install git git-http
2. Verifier que l'URL Git est correcte
3. Voir le log d'installation : cat /tmp/mm-install.log
4. Essayer l'installation manuelle : magicmirrorctl module install <url>

Configuration non appliquee

1. Verifier la syntaxe de la config (doit etre du JavaScript valide)
2. Redemarrer le service : /etc/init.d/magicmirror restart
3. Voir les logs du conteneur : magicmirrorctl logs
4. Restaurer la sauvegarde si necessaire : magicmirrorctl config restore

Le conteneur ne demarre pas

1. Verifier les cgroups : ls -la /sys/fs/cgroup
2. Verifier que Docker fonctionne : /etc/init.d/dockerd status
3. Verifier l'espace disque : df -h
4. Telecharger l'image manuellement : docker pull karsten13/magicmirror:latest

Ressources

• Site officiel : https://magicmirror.builders/
• Documentation : https://docs.magicmirror.builders/
• Modules tiers : https://github.com/MichMich/MagicMirror/wiki/3rd-party-modules
• Forum communautaire : https://forum.magicmirror.builders/
• GitHub : https://github.com/MichMich/MagicMirror

Licence

Apache-2.0

Auteur

CyberMind Studio contact@cybermind.fr