WLED Backup Predefinições Configuração WLED Max Passo a passo

Backup e restauração da configuração do WLED (cfg.json, presets.json e paletas)

Quais arquivos do WLED salvar (cfg.json, presets.json, paletas), como restaurar num ESP32 novo e por que os agendamentos ficam no cfg.json.

Por Publicado em Atualizado em

A maioria das pessoas descobre onde o WLED guarda as configurações logo depois de perdê-las. Tudo fica em alguns arquivos JSON na memória flash da própria luz: cfg.json para as configurações (Wi-Fi, saídas de LED, sincronização, temporizadores) e presets.json para predefinições e sequências. Paletas personalizadas, ledmaps e mapas de controle remoto são arquivos separados. Guarde cópias antes de cada atualização de firmware e antes de trocar um controlador. O método pela interface web abaixo é grátis e só precisa de um navegador.

Quais arquivos importam

ArquivoO que tem neleFazer backup?
cfg.jsonWi-Fi, saídas de LED, GPIO, limite de corrente, sincronização, hora e temporizadores, configurações de usermodssim
presets.jsontodas as predefinições e sequênciassim
palette0.json, palette1.json…paletas personalizadas (WLED 0.14 e mais recentes; até 10 no 0.14, no 0.15 e no ESP8266, muitas mais no WLED 16 com ESP32)se você criou alguma
ledmap.json, ledmap1.json…mapas de pixels personalizados para matrizes e disposições diferentesse você usa
ir.json, remote.jsonmapeamento de botões do controle remoto IR e do controle ESP-NOWse você usa

Temporizadores e agendamentos ficam no cfg.json, não no presets.json. As pessoas restauram as predefinições, procuram o temporizador do pôr do sol e ele sumiu. É por isso.

Backup pelo navegador

  1. Abra a luz no navegador e vá em Config›Security & Updates.
  2. Toque em Backup presets. O navegador baixa o presets.json.
  3. Toque em Backup configuration. O navegador baixa o cfg.json.
  4. Renomeie os dois com o nome da luz e a data, como porch-cfg-2026-05-10.json. Senão você acaba com dez arquivos chamados cfg.json.
Interface web do WLED
Seção Backup and Restore da página Security and Updates do WLED: um aviso de que restaurar vai sobrescrever as predefinições e a configuração atuais, Backup presets, Restore presets com um seletor de arquivo e Upload, Backup configuration, Restore configuration com um seletor de arquivo e Upload
Os botões de backup e restauração no WLED 16.0.1. As versões mais antigas são iguais.

Paletas e ledmaps não estão nessa página. Abra http://<light-ip>/edit, o editor de arquivos do WLED, e baixe cada arquivo por ali.

Restaurando

Na mesma página: Restore presets e Restore configuration. Escolha o arquivo e toque em Upload. A luz reinicia depois de restaurar uma configuração. As senhas não ficam no backup, então conte com digitar a senha do Wi-Fi de novo quando colocar uma configuração numa placa nova.

Restaurar uma configuração numa placa diferente pede um pouco de cuidado.

As configurações de Wi-Fi e de rede vêm junto. Se a luz antiga tinha um IP fixo e continua funcionando, agora você tem duas luzes com o mesmo endereço.

O GPIO e o tipo de LED também vêm. Se a placa nova usa outro pino de dados (uma placa QuinLED em vez de uma D1 mini, por exemplo), a fita fica apagada até você corrigir as saídas em LED & Hardware (chamado LED Preferences no 0.15 e anteriores).

Atenção

Restaurar uma configuração traz junto as configurações de rede e o pino de dados da placa antiga. Numa placa diferente, confira o IP e as saídas de LED logo depois.

Passar de ESP8266 para ESP32, ou o contrário, é possível, mas confira cada saída depois. Os chips têm numeração de pinos e limites diferentes.

Predefinições são muito mais seguras de mover do que configurações, porque uma predefinição guarda visuais, não configurações de hardware. O único porém são os IDs de efeito: o WLED 16 mudou o significado de alguns deles (o efeito 77, por exemplo), então predefinições criadas no 0.15 podem ficar diferentes no 16.

Backup e restauração no WLED Max

No WLED Max fica em Ajustes > Backup e restauração no iOS e em Configurações > Backup e restauração no Android.

Em Criar backup, escolha uma luz ao lado de Dispositivo (com uma luz só, ela já vem preenchida) e toque em Fazer backup agora.

iOS
Tela Backup e restauração do WLED Max no iPhone: Criar backup com um seletor Dispositivo em Porch Lights e um botão Fazer backup agora, Backups salvos vazio (Nenhum backup, Crie seu primeiro backup acima) e Migração com Copiar predefinições entre dispositivos
Backup e restauração antes do primeiro backup.
O app salva o cfg.json e o presets.json, todos os arquivos de paleta personalizada (palette0.json em diante), os ledmaps, o ir.json e o remote.json. Uma luz que nunca salvou uma predefinição não tem presets.json, então o app guarda um vazio em vez de falhar.

Esses backups ficam guardados com criptografia dentro do app no seu celular, e não há botão para exportar um como arquivo, então eles ficam só naquele celular. O Exportar dados do app do Android (também em Backup e restauração) salva num arquivo a sua lista de luzes, grupos e Predefinições Globais, mas não esses backups das luzes. Se você quer uma cópia fora do celular, baixe também os arquivos brutos pela interface web.

Para restaurar, toque num backup em Backups salvos. Restaurar em [luz original] coloca tudo de volta de onde veio. Restaurar em outro dispositivo… coloca em outra luz, por exemplo um ESP32 novo que substitui um que queimou.

A parte útil é aquilo em que ele não mexe. Uma restauração mantém as configurações de rede e de identidade da própria luz de destino. Restaurar o backup da varanda numa placa nova não copia o Wi-Fi, o IP fixo nem o nome da luz da varanda, então você não fica com duas luzes brigando pelo mesmo endereço. Visuais, predefinições, paletas e agendamentos vêm junto. As configurações da fiação dos LEDs só vêm quando isso é seguro (veja abaixo).

Desde a versão 1.1.4, no iOS e no Android, o app confere a luz que você escolheu e diz com palavras simples o que vai acontecer. Backups feitos com a 1.1.4 ou mais recente lembram de qual luz vieram.

  • A mesma luz. Você recebe um Restaurar simples, e tudo volta.
  • Outra luz com o mesmo chip. Você escolhe entre Restaurar tudo (útil quando um ESP32 novo substitui um queimado com a mesma fiação) e Restaurar sem mudar os LEDs.
  • Um chip diferente, por exemplo um backup de ESP32 indo para um ESP8266, ou para um ESP32-S3 ou C3. Só Restaurar sem mudar os LEDs é oferecido. A luz mantém as próprias saídas de LED, pinos de dados, tipo e quantidade de LEDs, botões, pinos de IR e de relé, disposição da matriz, ledmaps e configurações de extensões (usermods). Todo o resto vem do backup.
  • Pinos que a luz não tem. O mesmo que um chip diferente: a luz mantém a própria configuração de LEDs, e o app diz quais são os pinos, por exemplo GPIO 25.
  • Backups mais antigos (feitos antes da 1.1.4) não dizem de onde vieram, então o app sugere manter a configuração de LEDs da luz. Restaurar tudo continua lá se você sabe que a fiação é a mesma.

Ele também avisa sobre o firmware. Um backup de um WLED mais novo indo para um mais antigo pula as configurações que a versão antiga não conhece, e os agendamentos podem não funcionar do mesmo jeito. Do 0.15 para o 16, alguns efeitos mudaram, então algumas predefinições podem ficar um pouco diferentes. Um backup do WLED MoonModules indo para o WLED padrão, ou o contrário, também ganha uma nota.

Restaurar em [luz original] continua encontrando a luz certa mesmo depois que o roteador deu um endereço novo para ela. Se outra luz responder agora no endereço antigo, o app para, avisa (“Esta é outra luz”) e não muda nada.

A mesma tela também tem Copiar predefinições entre dispositivos em Migração. Os passos e os cuidados estão no guia de predefinições.

Se o presets.json de uma luz for danificado (uma queda de energia no meio de um salvamento faz isso), a aba Predefinições percebe e oferece Salvar uma cópia do arquivo antes de qualquer outra coisa. Guarde essa cópia. Muitas vezes dá para tirar a maioria das predefinições dela à mão.

Quando fazer backup

Depois de terminar de configurar uma luz. Antes de cada atualização de firmware. Antes de mudanças grandes em predefinições ou segmentos, principalmente a reforma anual para as datas comemorativas.

E guarde também um backup da interface web num computador. Um backup que só existe no celular some se você apagar os dados do app ou perder o celular.

Problemas na restauração

A restauração terminou, mas a fita está apagada. A configuração veio de uma placa com outro pino de dados ou outro tipo de LED. Confira as saídas em LED & Hardware (LED Preferences no 0.15). O WLED Max 1.1.4 mantém sozinho a configuração de LEDs do destino quando os chips são diferentes, então isso acontece mais com a restauração pela interface web ou com Restaurar tudo.

As predefinições foram restauradas, mas os efeitos estão errados. Ou é uma diferença de firmware (veja a nota sobre IDs de efeito acima), ou o efeito não existe na compilação do destino, como efeitos de áudio numa compilação sem AudioReactive.

Os agendamentos sumiram depois de restaurar. Você restaurou só o presets.json. Os temporizadores ficam no cfg.json.

As paletas personalizadas sumiram. Elas são arquivos separados. Coloque de volta pelo /edit, ou use o backup do WLED Max, que inclui as paletas.

Vai atualizar o firmware em seguida? Leia antes atualização OTA do WLED no ESP8266 e no ESP02. Se o que você está trocando na verdade é o celular, não as luzes, veja como levar a configuração do seu app de WLED para um celular novo.

Quem escreveu

Jamie Conde, que desenvolve o app WLED Max na MeowScript. O WLED é um projeto independente de código aberto, e nós não fazemos parte dele. WLED Max, nosso app de WLED para iOS e Android, é grátis para uma luz, sem nada bloqueado. Uma compra única libera mais luzes.