# 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) :**
```bash
# Méthode 1 : Via le dialogue "Exécuter"
# Appuyez sur Alt+F2
# Tapez : r
# Appuyez sur Entrée
```

**Sur Wayland :**
```bash
# Déconnectez-vous et reconnectez-vous
# Ou redémarrez votre session
```

**Alternative - Redémarrer complètement :**
```bash
# 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

```bash
# 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

```bash
# 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"

```bash
# 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

```bash
# 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

```bash
# 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](README.md)
- **Guide débutant** : [GUIDE_DEBUTANT.md](GUIDE_DEBUTANT.md)
- **Architecture** : [STRUCTURE.md](STRUCTURE.md)

## 🎯 Résumé rapide

```bash
# 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.