Files
gnome-asus-kbd-rgb/docs/RECAPITULATIF_WALLPAPERS.md
2025-12-28 09:35:23 +01:00

220 lines
6.4 KiB
Markdown

# 🎨 Récapitulatif : Changement automatique de fond d'écran
## ✅ Fonctionnalité implémentée
L'extension change maintenant automatiquement le fond d'écran GNOME en fonction de la couleur d'accentuation sélectionnée.
## 📊 État actuel de vos wallpapers
### Wallpapers installés : 10/9 ✅
Vous avez **10 fichiers** dans le dossier `wallpapers/` :
| Fichier | Taille | Correspond à |
|---------|--------|--------------|
| `ec_v_blue.jpg` | 3.3 Mo | ✅ Bleu GNOME |
| `ec_v_green.jpg` | 3.2 Mo | ✅ Vert GNOME |
| `ec_v_orange.jpg` | 4.8 Mo | ✅ Orange GNOME |
| `ec_v_pink.jpg` | 4.9 Mo | ✅ Rose GNOME |
| `ec_v_purple.jpg` | 3.2 Mo | ✅ Violet GNOME |
| `ec_v_red.jpg` | 4.6 Mo | ✅ Rouge GNOME |
| `ec_v_slate.jpg` | 4.2 Mo | ✅ Ardoise GNOME |
| `ec_v_teal.jpg` | 5.0 Mo | ✅ Turquoise GNOME |
| `ec_v_yellow.jpg` | 4.8 Mo | ✅ Jaune GNOME |
| `ec_v_turquoise.jpg` | 4.8 Mo | ⚠️ Doublon (teal = turquoise) |
### ⚠️ Remarque
Vous avez **2 fichiers** pour la turquoise :
- `ec_v_teal.jpg`**Utilisé par l'extension**
- `ec_v_turquoise.jpg` → Non utilisé (doublon)
**Action recommandée** : Vous pouvez supprimer `ec_v_turquoise.jpg` car l'extension utilise le nom interne GNOME `teal`.
## 🚀 Comment utiliser
### Activation
1. **Rechargez GNOME Shell** après l'installation :
- Appuyez sur `Alt+F2`
- Tapez `r`
- Appuyez sur `Entrée`
2. **Activez la synchronisation** :
- Cliquez sur l'icône de l'extension dans le panneau
- Cochez "Synchroniser thème GNOME"
3. **Changez de couleur** :
- Via les presets (9 cercles de couleur)
- Via la roue chromatique
- Via les sliders RGB
### Résultat attendu
Quand vous sélectionnez une couleur, **3 choses changent automatiquement** :
1. 🎹 **Couleur du clavier RGB**
2. 🎨 **Couleur d'accentuation GNOME**
3. 🖼️ **Fond d'écran GNOME**
## 🔍 Vérification
### 1. Vérifier que les wallpapers sont installés
```bash
ls -lh ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/
```
Vous devriez voir vos 10 fichiers copiés.
### 2. Tester le changement de wallpaper
1. Activer "Synchroniser thème GNOME"
2. Cliquer sur un preset (ex: orange)
3. Observer que :
- Le clavier change de couleur
- La couleur GNOME change (fenêtres, menus)
- **Le fond d'écran change** → `ec_v_orange.jpg`
### 3. Voir les logs de changement
```bash
journalctl -f -o cat /usr/bin/gnome-shell | grep -i "fond\|wallpaper"
```
Vous devriez voir :
```
[ASUS RGB] Fond d'écran changé → orange (/home/gilles/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/ec_v_orange.jpg)
```
## 📝 Correspondance couleur ↔ wallpaper
| Preset | Nom GNOME | Fichier utilisé | Hex | RGB |
|--------|-----------|-----------------|-----|-----|
| 1 | blue | `ec_v_blue.jpg` | #3584e4 | (53, 132, 228) |
| 2 | teal | `ec_v_teal.jpg` | #2190a4 | (33, 144, 164) |
| 3 | green | `ec_v_green.jpg` | #3a944a | (58, 148, 74) |
| 4 | yellow | `ec_v_yellow.jpg` | #c88800 | (200, 136, 0) |
| 5 | orange | `ec_v_orange.jpg` | #ed5b00 | (237, 91, 0) |
| 6 | red | `ec_v_red.jpg` | #e62d42 | (230, 45, 66) |
| 7 | pink | `ec_v_pink.jpg` | #d56199 | (213, 97, 153) |
| 8 | purple | `ec_v_purple.jpg` | #9141ac | (145, 65, 172) |
| 9 | slate | `ec_v_slate.jpg` | #6f8396 | (111, 131, 150) |
## 🛠️ Comportement en cas de wallpaper manquant
Si un fichier wallpaper n'existe pas (par exemple, si vous supprimez `ec_v_blue.jpg`), l'extension :
- ✅ Change quand même la couleur du clavier
- ✅ Change quand même la couleur GNOME
- ⚠️ N'applique pas de wallpaper (log informatif dans journalctl)
- ❌ N'affiche PAS d'erreur à l'utilisateur
**Log** :
```
[ASUS RGB] Fond d'écran non trouvé : /home/.../.../ec_v_blue.jpg
```
## 🎯 Désactiver uniquement le changement de wallpaper
Si vous voulez garder la synchronisation thème mais **sans** changer le fond d'écran :
### Option 1 : Supprimer les fichiers wallpapers
```bash
rm ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/ec_v_*.jpg
```
### Option 2 : Modifier le code
1. Ouvrir `extension/ui.js`
2. Ligne 619, commenter :
```javascript
// this._changeWallpaper(accentColor);
```
3. Réinstaller : `./tools/install-local.sh`
## 📦 Fichiers créés/modifiés
### Nouveaux fichiers
1. `wallpapers/` - Dossier pour les fonds d'écran
2. `wallpapers/README.md` - Documentation du système de nommage
3. `wallpapers/.gitignore` - Ignore les .jpg (pas commités dans git)
4. `docs/WALLPAPERS.md` - Guide complet d'utilisation
5. `docs/RECAPITULATIF_WALLPAPERS.md` - Ce fichier
### Fichiers modifiés
1. `extension/ui.js` :
- Nouvelle fonction `_changeWallpaper(accentColor)` (ligne 558-587)
- Appel dans `_syncGnomeTheme()` (ligne 619)
2. `tools/install-local.sh` :
- Ajout variable `PROJECT_DIR` (ligne 16)
- Copie automatique des wallpapers (ligne 112-128)
- Comptage et affichage du nombre de wallpapers
3. `CHANGELOG.md` :
- Ajout "Amélioration 9: Changement automatique de fond d'écran"
## 🎨 Optimisation des wallpapers (optionnel)
Vos wallpapers font entre 3.2 Mo et 5.0 Mo chacun. Pour optimiser :
```bash
cd wallpapers/
# Optimiser tous les .jpg (qualité 85%)
for img in ec_v_*.jpg; do
convert "$img" -quality 85 "${img%.jpg}_opt.jpg"
done
# Vérifier la taille
ls -lh ec_v_*_opt.jpg
# Si satisfait, remplacer
for img in ec_v_*_opt.jpg; do
mv "$img" "${img%_opt.jpg}.jpg"
done
```
## ✅ Prochaines étapes
1. **Recharger GNOME Shell** : `Alt+F2` → `r`
2. **Activer "Synchroniser thème GNOME"** dans l'extension
3. **Tester** en cliquant sur différents presets
4. **Optionnel** : Supprimer `ec_v_turquoise.jpg` (doublon)
5. **Optionnel** : Optimiser la taille des wallpapers si vous voulez
## 🐛 En cas de problème
### Le fond d'écran ne change pas
**Vérifier** :
```bash
# 1. Extension activée
gnome-extensions list --enabled | grep asus
# 2. Synchronisation activée (via l'interface)
# 3. Wallpapers présents
ls ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/
# 4. Logs
journalctl -f -o cat /usr/bin/gnome-shell | grep "ASUS RGB"
```
### Permissions
```bash
# Vérifier que les fichiers sont lisibles
ls -la ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/
```
Tous les fichiers doivent être en mode `rw-` (lecture/écriture pour vous).
## 📖 Documentation complète
Consultez `docs/WALLPAPERS.md` pour :
- Guide de création de wallpapers personnalisés
- Exemples avec ImageMagick
- Conseils de design
- Dépannage avancé