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

🎨 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

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

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

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 :

   // 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 :

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 :

# 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

# 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é