ajout wallpaper

docs/WALLPAPERS.md

@@ -0,0 +1,193 @@
+# Configuration des fonds d'écran par couleur
+
+Cette extension peut changer automatiquement votre fond d'écran GNOME en fonction de la couleur d'accentuation sélectionnée.
+
+## 📋 Prérequis
+
+Vous devez créer 9 fonds d'écran correspondant aux 9 couleurs d'accentuation GNOME.
+
+## 📁 Emplacement des fichiers
+
+Placez vos images dans le dossier : `wallpapers/`
+
+## 🏷️ Convention de nommage
+
+Les fichiers **doivent** être nommés selon ce format : `ec_v_<couleur>.jpg`
+
+| Nom du fichier | Couleur GNOME | Hex | RGB |
+|----------------|---------------|-----|-----|
+| `ec_v_blue.jpg` | Bleu | #3584e4 | (53, 132, 228) |
+| `ec_v_teal.jpg` | Turquoise | #2190a4 | (33, 144, 164) |
+| `ec_v_green.jpg` | Vert | #3a944a | (58, 148, 74) |
+| `ec_v_yellow.jpg` | Jaune | #c88800 | (200, 136, 0) |
+| `ec_v_orange.jpg` | Orange | #ed5b00 | (237, 91, 0) |
+| `ec_v_red.jpg` | Rouge | #e62d42 | (230, 45, 66) |
+| `ec_v_pink.jpg` | Rose | #d56199 | (213, 97, 153) |
+| `ec_v_purple.jpg` | Violet | #9141ac | (145, 65, 172) |
+| `ec_v_slate.jpg` | Ardoise | #6f8396 | (111, 131, 150) |
+
+## 🎨 Format des images
+
+- **Format** : JPG (recommandé pour la taille)
+- **Résolution** : Adaptée à votre écran (ex: 1920×1080, 2560×1440, 3840×2160)
+- **Taille de fichier** : Optimisée (< 1 Mo par image si possible)
+
+## 📦 Installation
+
+1. **Placez vos 9 images** dans le dossier `wallpapers/` :
+   ```bash
+   cd /home/gilles/Documents/vscode/gnome-asus-kbd-rgb/wallpapers/
+   # Copiez vos 9 fichiers ec_v_*.jpg ici
+   ```
+
+2. **Vérifiez les noms** :
+   ```bash
+   ls -1 ec_v_*.jpg
+   ```
+
+   Vous devriez voir :
+   ```
+   ec_v_blue.jpg
+   ec_v_green.jpg
+   ec_v_orange.jpg
+   ec_v_pink.jpg
+   ec_v_purple.jpg
+   ec_v_red.jpg
+   ec_v_slate.jpg
+   ec_v_teal.jpg
+   ec_v_yellow.jpg
+   ```
+
+3. **Installez l'extension** :
+   ```bash
+   ./tools/install-local.sh
+   ```
+
+   Le script copiera automatiquement les wallpapers dans :
+   `~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/`
+
+## 🚀 Utilisation
+
+1. **Activez la synchronisation du thème** dans l'extension
+   - Cliquez sur l'icône de l'extension dans le panneau
+   - Cochez "Synchroniser thème GNOME"
+
+2. **Changez de couleur** (via presets, roue, ou sliders)
+   - Le fond d'écran changera automatiquement pour correspondre à la couleur
+
+3. **Comportement** :
+   - Si le fichier wallpaper n'existe pas, un message apparaît dans les logs (pas d'erreur)
+   - Le fond d'écran s'applique en mode clair ET sombre
+
+## 🔍 Vérification
+
+### Vérifier que les wallpapers sont installés
+
+```bash
+ls ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/
+```
+
+### Vérifier les logs de changement de wallpaper
+
+```bash
+journalctl -f -o cat /usr/bin/gnome-shell | grep -i wallpaper
+```
+
+Vous devriez voir :
+```
+[ASUS RGB] Fond d'écran changé → blue (/home/gilles/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/ec_v_blue.jpg)
+```
+
+### Vérifier le wallpaper actuel
+
+```bash
+gsettings get org.gnome.desktop.background picture-uri
+```
+
+## 🎯 Conseils pour créer vos wallpapers
+
+### Option 1 : Wallpapers unis avec dégradé
+- Créez un dégradé avec la couleur GNOME comme couleur dominante
+- Utilisez un outil comme GIMP ou Inkscape
+
+### Option 2 : Wallpapers existants avec overlay de couleur
+- Prenez une image de base
+- Appliquez un overlay semi-transparent avec la couleur GNOME
+- Ajustez l'opacité pour que la couleur soit visible mais pas trop forte
+
+### Option 3 : Wallpapers thématiques
+- Bleu : ciel, océan
+- Vert : forêt, nature
+- Orange : coucher de soleil
+- Rouge : feu, passion
+- etc.
+
+### Exemple avec ImageMagick
+
+Créer un dégradé simple :
+```bash
+# Bleu
+convert -size 1920x1080 gradient:#1a3b66-#3584e4 ec_v_blue.jpg
+
+# Orange
+convert -size 1920x1080 gradient:#6b2d00-#ed5b00 ec_v_orange.jpg
+
+# Etc. pour chaque couleur
+```
+
+Appliquer un overlay de couleur sur une image existante :
+```bash
+# Base image + overlay bleu semi-transparent
+convert base_wallpaper.jpg -fill "#3584e4" -colorize 30% ec_v_blue.jpg
+```
+
+## 🐛 Dépannage
+
+### "Fond d'écran non trouvé" dans les logs
+
+**Cause** : Le fichier n'existe pas ou le nom est incorrect
+
+**Solution** :
+1. Vérifiez le nom exact : `ec_v_<couleur>.jpg` (tout en minuscules)
+2. Vérifiez que le fichier est dans `wallpapers/`
+3. Réinstallez l'extension : `./tools/install-local.sh`
+
+### Le fond d'écran ne change pas
+
+**Cause** : Synchronisation du thème désactivée
+
+**Solution** : Activez "Synchroniser thème GNOME" dans l'extension
+
+### Les wallpapers ne sont pas copiés lors de l'installation
+
+**Vérifications** :
+```bash
+# Vérifier que le dossier existe
+ls -la wallpapers/
+
+# Vérifier qu'il y a des fichiers .jpg
+ls wallpapers/ec_v_*.jpg
+
+# Réinstaller
+./tools/install-local.sh
+```
+
+## 📝 Notes
+
+- Les wallpapers **ne sont pas** commités dans Git (fichier `.gitignore`)
+- Vous devez créer ou fournir vos propres images
+- Les images sont copiées localement, pas référencées depuis le projet
+- Vous pouvez utiliser des formats PNG en modifiant l'extension (changez `.jpg` en `.png` dans `ui.js`)
+
+## 🔄 Désactiver le changement de fond d'écran
+
+Si vous voulez garder la synchronisation du thème GNOME mais **sans** changer le fond d'écran :
+
+1. Ouvrez `extension/ui.js`
+2. Dans la fonction `_syncGnomeTheme()`, commentez cette ligne :
+   ```javascript
+   // this._changeWallpaper(accentColor);
+   ```
+3. Réinstallez l'extension
+
+Ou supprimez simplement tous les fichiers wallpapers du dossier `wallpapers/`.