Sauvegarder et restaurer une configuration WLED (cfg.json, presets.json et palettes)
Quels fichiers WLED sauvegarder (cfg.json, presets.json, palettes), comment les restaurer sur un nouvel ESP32, et pourquoi les programmations sont dans cfg.json.
La plupart des gens découvrent où WLED range ses réglages juste après les avoir perdus. Tout tient dans quelques fichiers JSON sur la mémoire flash de la lumière : cfg.json pour les réglages (Wi-Fi, sorties LED, synchronisation, minuteurs) et presets.json pour les préréglages et les listes de lecture. Les palettes personnalisées, les ledmaps et les correspondances de télécommande sont des fichiers à part. Faites-en des copies avant chaque mise à jour du firmware et avant de changer de contrôleur. La méthode par l’interface web décrite plus bas est gratuite et ne demande qu’un navigateur.
Les fichiers qui comptent
| Fichier | Contenu | À sauvegarder ? |
|---|---|---|
| cfg.json | Wi-Fi, sorties LED, GPIO, limite de courant, synchronisation, heure et minuteurs, réglages des modules utilisateur | oui |
| presets.json | tous les préréglages et listes de lecture | oui |
| palette0.json, palette1.json… | palettes personnalisées (WLED 0.14 et suivants ; jusqu’à 10 sous 0.14, 0.15 et sur ESP8266, beaucoup plus sous WLED 16 avec un ESP32) | si vous en avez créé |
| ledmap.json, ledmap1.json… | correspondances de pixels personnalisées pour les matrices et les dispositions inhabituelles | si vous les utilisez |
| ir.json, remote.json | correspondances des boutons de télécommande IR et ESP-NOW | si vous les utilisez |
Les minuteurs et les programmations sont dans cfg.json, pas dans presets.json. Des gens restaurent leurs préréglages, cherchent leur minuteur du coucher du soleil, et il a disparu. Voilà pourquoi.
Sauvegarder depuis un navigateur
- Ouvrez la lumière dans un navigateur et allez dans Config›Security & Updates.
- Touchez Backup presets. Le navigateur télécharge presets.json.
- Touchez Backup configuration. Le navigateur télécharge cfg.json.
- Renommez les deux avec le nom de la lumière et la date, par exemple
porch-cfg-2026-05-10.json. Sinon, vous vous retrouvez avec dix fichiers qui s’appellent tous cfg.json.

Les palettes et les ledmaps ne sont pas sur cette page. Ouvrez http://<light-ip>/edit, l’éditeur de fichiers de WLED, et téléchargez chaque fichier depuis là.
Restaurer
Même page : Restore presets et Restore configuration. Choisissez le fichier, puis touchez Upload. La lumière redémarre après une restauration de configuration. Les mots de passe ne font pas partie de la sauvegarde, attendez-vous donc à retaper le mot de passe Wi-Fi quand vous chargez une configuration sur une carte neuve.
Restaurer une configuration sur une autre carte demande un peu de prudence.
Les réglages Wi-Fi et réseau sont repris. Si l’ancienne lumière avait une IP fixe et fonctionne encore, vous avez maintenant deux lumières à la même adresse.
Il en va de même pour le GPIO et le type de LED. Si la nouvelle carte utilise une autre broche de données (une carte QuinLED au lieu d’un D1 mini, par exemple), le ruban reste éteint tant que vous n’avez pas corrigé les sorties sous LED & Hardware (appelé LED Preferences sous 0.15 et versions antérieures).
Une restauration de configuration apporte les réglages réseau et la broche de données de l'ancienne carte. Sur une autre carte, vérifiez l'IP et les sorties LED juste après.
Passer d’un ESP8266 à un ESP32, ou l’inverse, est possible, mais vérifiez chaque sortie ensuite. Les puces ont des numéros de broches et des limites différents.
Les préréglages se transfèrent bien plus sûrement que les configurations, parce qu’un préréglage contient des ambiances, pas des réglages matériels. Le seul piège concerne les numéros d’effets : WLED 16 a changé le sens de certains (l’effet 77, par exemple), donc des préréglages créés sous 0.15 peuvent avoir un autre rendu sous 16.
Sauvegarde et restauration dans WLED Max
Dans WLED Max, c’est dans Réglages > Sauvegarde et restauration, sur iOS et Android.
Sous Créer une sauvegarde, choisissez une lumière à côté d’Appareil (avec une seule lumière, le champ est déjà rempli) et touchez Sauvegarder maintenant.

Ces sauvegardes sont stockées chiffrées dans l’app sur votre téléphone, et aucun bouton ne permet d’en exporter une sous forme de fichier : elles restent donc sur ce téléphone. Sur Android, Exporter les données de l’app (aussi dans Sauvegarde et restauration) enregistre dans un fichier votre liste de lumières, les groupes et les préréglages globaux, mais pas ces sauvegardes de lumières. Si vous voulez une copie hors du téléphone, téléchargez aussi les fichiers bruts depuis l’interface web.
Pour restaurer, touchez une sauvegarde sous Sauvegardes enregistrées. Restaurer sur [lumière d’origine] remet tout sur la lumière d’origine. Restaurer sur un autre appareil… l’applique à une autre lumière, par exemple un nouvel ESP32 qui remplace un contrôleur mort.
L’intérêt, c’est ce que la restauration laisse de côté. Une restauration conserve les réglages réseau et l’identité de la lumière cible. Restaurer la sauvegarde du porche sur une nouvelle carte ne copie ni le Wi-Fi, ni l’IP fixe, ni le nom de la lumière du porche, vous n’avez donc pas deux lumières qui se disputent une adresse. Les ambiances, les préréglages, les palettes et les programmations sont repris. Les réglages de câblage LED ne sont repris que lorsque c’est sans risque (voir plus bas).
Depuis la version 1.1.4, sur iOS et Android, l’app vérifie la lumière choisie et vous dit clairement ce qui va se passer. Les sauvegardes faites avec la 1.1.4 ou plus récente savent de quelle lumière elles viennent.
- Même lumière. Vous avez un simple Restaurer, et tout revient.
- Une autre lumière avec la même puce. Vous choisissez entre Tout restaurer (pratique quand un nouvel ESP32 câblé de la même façon remplace un contrôleur mort) et Restaurer sans changer les LED.
- Une autre puce, par exemple une sauvegarde d’ESP32 vers un ESP8266, ou vers un ESP32-S3 ou C3. Seul Restaurer sans changer les LED est proposé. La lumière garde ses propres sorties LED, broches de données, type et nombre de LED, boutons, broches IR et relais, disposition de matrice, ledmaps et réglages des modules utilisateur. Tout le reste vient de la sauvegarde.
- Des broches que la lumière n’a pas. Comme pour une autre puce : la lumière garde sa configuration LED, et l’app nomme les broches, par exemple GPIO 25.
- Les sauvegardes plus anciennes (faites avant la 1.1.4) ne disent pas d’où elles viennent, l’app propose donc de garder la configuration LED de la lumière. Tout restaurer reste disponible si vous savez que le câblage correspond.
L’app vous avertit aussi au sujet du firmware. Une sauvegarde d’un WLED plus récent restaurée sur un plus ancien ignore les réglages que l’ancienne version ne connaît pas, et les programmations peuvent ne pas fonctionner de la même façon. De 0.15 à 16, quelques effets ont changé, certains préréglages peuvent donc avoir un rendu un peu différent. Une sauvegarde de WLED MoonModules restaurée sur WLED standard, ou l’inverse, a aussi droit à une note.
Restaurer sur [lumière d’origine] retrouve la bonne lumière même après que votre routeur lui a donné une nouvelle adresse. Si une autre lumière répond maintenant à l’ancienne adresse, l’app s’arrête, vous le dit (« C’est une autre lumière ») et ne change rien.
Le même écran propose aussi Copier les préréglages entre appareils sous Migration. Les étapes et les précautions sont dans le guide des préréglages.
Si le presets.json d’une lumière est endommagé (une coupure de courant au milieu d’un enregistrement suffit), l’onglet Préréglages s’en aperçoit et propose Enregistrer une copie du fichier avant toute autre chose. Gardez cette copie. On peut souvent en extraire à la main la plupart des préréglages.
Quand sauvegarder
Après avoir fini de configurer une lumière. Avant chaque mise à jour du firmware. Avant de gros changements de préréglages ou de segments, surtout le remaniement annuel pour les fêtes.
Et gardez aussi une sauvegarde faite par l’interface web sur un ordinateur. Une sauvegarde qui n’existe que sur votre téléphone disparaît si vous réinitialisez l’app ou perdez le téléphone.
Problèmes de restauration
La restauration est terminée mais le ruban reste éteint. La configuration vient d’une carte avec une autre broche de données ou un autre type de LED. Vérifiez les sorties sous LED & Hardware (LED Preferences sous 0.15). WLED Max 1.1.4 garde d’office la configuration LED de la cible quand les puces diffèrent, cela arrive donc surtout avec la restauration par l’interface web ou avec Tout restaurer.
Préréglages restaurés mais effets incorrects. Soit une différence de firmware (voir la remarque sur les numéros d’effets plus haut), soit l’effet n’existe pas dans le build de la cible, comme les effets audio sur un build sans AudioReactive.
Programmations absentes après restauration. Vous n’avez restauré que presets.json. Les minuteurs sont dans cfg.json.
Palettes personnalisées absentes. Ce sont des fichiers à part. Remettez-les via /edit, ou utilisez la sauvegarde WLED Max, qui les inclut.
Vous prévoyez une mise à jour du firmware ? Lisez d’abord mise à jour OTA de WLED sur ESP8266 et ESP02. Si c’est votre téléphone que vous changez, et pas vos lumières, voir transférer la configuration de votre app WLED sur un nouveau téléphone.