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

   cd /home/gilles/Documents/vscode/gnome-asus-kbd-rgb/wallpapers/
   # Copiez vos 9 fichiers ec_v_*.jpg ici
   

2. Vérifiez les noms :

   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 :

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

ls ~/.local/share/gnome-shell/extensions/asus-kbd-rgb@gilles/wallpapers/

Vérifier les logs de changement de wallpaper

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

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 :

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

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

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

   // this._changeWallpaper(accentColor);
   

3. Réinstallez l'extension

Ou supprimez simplement tous les fichiers wallpapers du dossier wallpapers/.