pilot/gnome-pilot-extension/DEMARRAGE.md

Comment lancer l'extension Pilot Control

✅ L'extension est installée et corrigée !

L'extension a été mise à jour pour supporter GNOME Shell 48.

🚀 Étapes pour utiliser l'extension

1. Redémarrer GNOME Shell

Sur X11 (recommandé si vous êtes sur X11) :

# Méthode 1 : Via le dialogue "Exécuter"
# Appuyez sur Alt+F2
# Tapez : r
# Appuyez sur Entrée

Sur Wayland :

# Déconnectez-vous et reconnectez-vous
# Ou redémarrez votre session

Alternative - Redémarrer complètement :

# Si les méthodes ci-dessus ne fonctionnent pas
sudo systemctl restart gdm
# Ou redémarrez l'ordinateur

2. Vérifier que l'extension est activée

# Vérifier le statut
gnome-extensions list --enabled | grep pilot

# Si elle n'est pas activée, l'activer :
gnome-extensions enable pilot-control@gnome-shell-extensions

3. Localiser l'icône dans le panel

Après le redémarrage de GNOME Shell, vous devriez voir :

┌─────────────────────────────────────────────────┐
│  [WiFi] [Volume] [🖥️ Computer] [Power] [Clock] │
│                    ↑                            │
│                    └─ Icône Pilot Control       │
└─────────────────────────────────────────────────┘

L'icône ressemble à un ordinateur (computer-symbolic).

4. Utiliser l'extension

Option 1 : Menu rapide

1. Cliquez sur l'icône d'ordinateur
2. Vous verrez le menu :

   Status: 🟢 Running (ou 🔴 Stopped)
   ──────────────────────
   Open Control Panel
   ──────────────────────
   Start Service
   Stop Service
   Restart Service
   ──────────────────────
   Reload Config
   

Option 2 : Fenêtre complète

1. Cliquez sur l'icône
2. Cliquez sur "Open Control Panel"
3. La fenêtre principale s'ouvre avec 3 sections :
   • Service Control : Gérer le service
   • Telemetry Metrics : Gérer les métriques
   • Commands : Gérer les commandes autorisées

🔍 Dépannage

L'icône n'apparaît pas

# 1. Vérifier que l'extension est bien installée
ls ~/.local/share/gnome-shell/extensions/pilot-control@gnome-shell-extensions/

# 2. Vérifier qu'elle est activée
gnome-extensions list --enabled | grep pilot

# 3. Regarder les logs
journalctl --since "5 minutes ago" -o cat | grep -i pilot

# 4. Réinstaller l'extension
cd /home/gilles/app/pilot/gnome-pilot-extension
./install.sh

# 5. Redémarrer GNOME Shell (Alt+F2, 'r')

Message "Extension had error"

# Voir les erreurs détaillées
journalctl -f -o cat /usr/bin/gnome-shell | grep -i pilot

# Ou utiliser Looking Glass (debugger GNOME)
# Alt+F2, tapez 'lg', regardez l'onglet "Errors"

L'extension se charge mais rien ne se passe

# Vérifier que le service Pilot existe
systemctl --user status mqtt_pilot.service

# Vérifier que le config.yaml existe
cat ~/app/pilot/pilot-v2/config.yaml

# Tester manuellement l'extension
dbus-run-session -- gnome-shell --replace 2>&1 | grep -i pilot

📝 Actions courantes

Activer/désactiver une métrique

1. Ouvrir le Control Panel
2. Section "Telemetry Metrics"
3. Utiliser le switch à côté de la métrique
4. Cliquer sur [💾] Save (en haut à droite)
5. Le service redémarre automatiquement

Modifier l'intervalle d'une métrique

1. Ouvrir le Control Panel
2. Section "Telemetry Metrics"
3. Cliquer sur [...] à côté de la métrique
4. Modifier "Update Interval (seconds)"
5. Cliquer "Save" dans le dialogue
6. Cliquer [💾] Save dans la fenêtre principale

Gérer les commandes autorisées

1. Ouvrir le Control Panel
2. Section "Commands"
3. Cliquer sur "Allowed Commands"
4. Cocher/décocher les commandes (shutdown, reboot, etc.)
5. Cliquer "Save" dans le dialogue
6. Cliquer [💾] Save dans la fenêtre principale

Redémarrer le service Pilot

Méthode rapide :

1. Cliquer sur l'icône
2. Cliquer sur "Restart Service"

Méthode complète :

1. Ouvrir le Control Panel
2. Section "Service Control"
3. Cliquer sur le bouton "Restart"

🧪 Tester que tout fonctionne

# Script de test complet
cd /home/gilles/app/pilot/gnome-pilot-extension
./test.sh

# Vérifier manuellement
# 1. L'extension est activée
gnome-extensions list --enabled | grep pilot

# 2. Le service Pilot tourne
systemctl --user is-active mqtt_pilot.service

# 3. Le config.yaml est accessible
ls -l ~/app/pilot/pilot-v2/config.yaml

# 4. Les logs ne montrent pas d'erreur
journalctl --since "10 minutes ago" -o cat | grep -i "pilot.*error"

📖 Plus d'aide

• README complet : README.md
• Guide débutant : GUIDE_DEBUTANT.md
• Architecture : STRUCTURE.md

🎯 Résumé rapide

# 1. Redémarrer GNOME Shell (Alt+F2, 'r')

# 2. Chercher l'icône d'ordinateur en haut à droite

# 3. Cliquer dessus → "Open Control Panel"

# 4. Modifier vos paramètres

# 5. Cliquer sur [💾] Save

# 6. C'est tout ! Le service redémarre automatiquement

---

Note importante : L'extension a été corrigée pour supporter GNOME Shell 48. Elle devrait maintenant fonctionner correctement après un redémarrage de GNOME Shell.