gnome-asus-kbd-rgb/docs/WALLPAPERS.md

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