feat: full settings backup export/import in tools tab

Exports all settings sections plus RFID assignments as a JSON file;
WiFi credentials (incl. static-ip config) can optionally be included
via /savedSSIDs?credentials. Import replays the file through the
existing REST endpoints section by section.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: fhirschmann

html/locales/de.json

@@ -477,6 +477,23 @@
 		}
 	},
 	"tools": {
+		"backup": {
+			"title": "Backup",
+			"desc": "Exportiert bzw. importiert alle Einstellungen und RFID-Zuweisungen als JSON-Datei.",
+			"export": {
+				"title": "Export",
+				"includeWifi": "WLAN-Zugangsdaten einschließen",
+				"button": "Backup herunterladen"
+			},
+			"import": {
+				"title": "Import",
+				"desc": "Backup-Datei auswählen und importieren. Einige Einstellungen (z. B. MQTT) erfordern danach einen Neustart.",
+				"button": "Importieren",
+				"invalid": "Keine gültige Backup-Datei",
+				"partial": "Import mit {{count}} Fehlern abgeschlossen",
+				"done": "Import abgeschlossen"
+			}
+		},
 		"nvs": {
 			"title": "Gespeicherte RFID-Zuweisungen",
 			"desc": "Die RFID-Zuweisungen werden nicht auf der SD-Karte, sondern im internen, nicht-flüchtigen Speicher (NVS) des ESPuinos gespeichert.",

html/locales/en.json

@@ -479,6 +479,23 @@
 		}
 	},
 	"tools": {
+		"backup": {
+			"title": "Backup",
+			"desc": "Exports or imports all settings and RFID assignments as a JSON file.",
+			"export": {
+				"title": "Export",
+				"includeWifi": "Include WiFi credentials",
+				"button": "Download backup"
+			},
+			"import": {
+				"title": "Import",
+				"desc": "Select and import a backup file. Some settings (e.g. MQTT) require a restart afterwards.",
+				"button": "Import",
+				"invalid": "Not a valid backup file",
+				"partial": "Import finished with {{count}} errors",
+				"done": "Import finished"
+			}
+		},
 		"nvs": {
 			"title": "Saved RFID assignments",
 			"desc": "The RFID assignments are not stored on the SD card but on the internal, non-volative storage (NVS) of the ESPuino.",

html/locales/fr.json

@@ -466,6 +466,23 @@
 		}
 	},
 	"tools": {
+		"backup": {
+			"title": "Sauvegarde",
+			"desc": "Exporte ou importe tous les réglages et attributions RFID dans un fichier JSON.",
+			"export": {
+				"title": "Export",
+				"includeWifi": "Inclure les identifiants WiFi",
+				"button": "Télécharger la sauvegarde"
+			},
+			"import": {
+				"title": "Import",
+				"desc": "Sélectionner et importer un fichier de sauvegarde. Certains réglages (p. ex. MQTT) nécessitent ensuite un redémarrage.",
+				"button": "Importer",
+				"invalid": "Fichier de sauvegarde invalide",
+				"partial": "Import terminé avec {{count}} erreurs",
+				"done": "Import terminé"
+			}
+		},
 		"nvs": {
 			"title": "Affectations RFID enregistrées",
 			"desc": "Les affectations RFID ne sont pas stockées sur la carte SD, mais sur la mémoire interne non volatile (NVS) de l'ESPuino.",

html/management.html

@@ -2320,6 +2320,31 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 				</span>
 				<hr>
 			</div>
+			<div class="container" id="backup">
+				<legend data-i18n="tools.backup.title"></legend>
+				<p data-i18n="tools.backup.desc"></p>
+				<span class="container" style="padding: 0">
+					<p style="font-weight: bold" data-i18n="tools.backup.export.title"></p>
+					<div class="d-flex gap-2">
+						<input type="checkbox" id="backupIncludeWifi" value="false">
+						<label for="backupIncludeWifi" data-i18n="tools.backup.export.includeWifi"></label>
+					</div><br>
+					<button type="button" class="btn btn-primary" onclick="exportBackup()"
+						data-i18n="tools.backup.export.button"></button>
+					<br><br>
+				</span>
+				<span class="container" style="padding: 0">
+					<p style="font-weight: bold" data-i18n="tools.backup.import.title"></p>
+					<p data-i18n="tools.backup.import.desc"></p>
+					<input type="file" class="form-control-file btn btn-primary" id="backupUpload" accept=".json">
+					<br><br>
+					<div class="text-center">
+						<button type="button" class="btn btn-primary" onclick="importBackup()"
+							data-i18n="tools.backup.import.button"></button>
+					</div>
+				</span>
+				<hr>
+			</div>
 			<div class="container" id="httpUpdate">
 				<legend id="legendfwupdate" data-i18n="tools.fwupdate.title"></legend>
 				<form id="firmwareUploadForm" method="POST" enctype="multipart/form-data" action="/update">
@@ -4354,6 +4379,123 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 			}
 			return dDisplay + hDisplay + mDisplay;
 		}
+		async function exportBackup() {
+			const backup = {
+				espuinoBackup: 1,
+				created: new Date().toISOString(),
+				settings: await (await fetch("http://" + host + "/settings")).json(),
+				rfid: await (await fetch("http://" + host + "/rfid")).json()
+			};
+			delete backup.settings.ssids; // names only - not usable for a restore
+			if (document.getElementById('backupIncludeWifi').checked) {
+				backup.wifiConfig = await (await fetch("http://" + host + "/wificonfig")).json();
+				backup.wifiNetworks = await (await fetch("http://" + host + "/savedSSIDs?credentials=1")).json();
+			}
+			const blob = new Blob([JSON.stringify(backup, null, "\t")], {
+				type: "application/json"
+			});
+			const anchor = document.createElement('a');
+			anchor.href = URL.createObjectURL(blob);
+			anchor.download = 'espuino-backup_' + new Date().toISOString().substring(0, 10) + '.json';
+			anchor.click();
+			URL.revokeObjectURL(anchor.href);
+		}
+
+		async function importBackup() {
+			const fileInput = document.getElementById('backupUpload');
+			if (!fileInput.files.length) {
+				alert(i18next.t("files.upload.selectFile"));
+				return;
+			}
+			let backup;
+			try {
+				backup = JSON.parse(await fileInput.files[0].text());
+			} catch (e) {
+				toaster.error(i18next.t("tools.backup.import.invalid"));
+				return;
+			}
+			if (backup.espuinoBackup !== 1) {
+				toaster.error(i18next.t("tools.backup.import.invalid"));
+				return;
+			}
+			let errors = 0;
+			// the firmware applies one settings section per request
+			const sections = ['general', 'equalizer', 'led', 'battery', 'playlist', 'buttons', 'rotary', 'ftp', 'mqtt', 'bluetooth'];
+			for (const section of sections) {
+				if (backup.settings && backup.settings[section]) {
+					const response = await fetch("http://" + host + "/settings", {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json"
+						},
+						body: JSON.stringify({
+							[section]: backup.settings[section]
+						})
+					});
+					if (!response.ok) {
+						errors++;
+					}
+				}
+			}
+			if (Array.isArray(backup.rfid)) {
+				for (const entry of backup.rfid) {
+					if (!entry.id) {
+						continue;
+					}
+					const response = await fetch("http://" + host + "/rfid", {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json"
+						},
+						body: JSON.stringify(entry)
+					});
+					if (!response.ok) {
+						errors++;
+					}
+				}
+			}
+			if (Array.isArray(backup.wifiNetworks)) {
+				for (const network of backup.wifiNetworks) {
+					if (!network.ssid) {
+						continue;
+					}
+					const response = await fetch("http://" + host + "/savedSSIDs", {
+						method: "POST",
+						headers: {
+							"Content-Type": "application/json"
+						},
+						body: JSON.stringify(network)
+					});
+					if (!response.ok) {
+						errors++;
+					}
+				}
+				await rebuildSSIDList();
+			}
+			if (backup.wifiConfig) {
+				const response = await fetch("http://" + host + "/wificonfig", {
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json"
+					},
+					body: JSON.stringify(backup.wifiConfig)
+				});
+				if (!response.ok) {
+					errors++;
+				}
+			}
+			if (errors) {
+				toaster.warning(i18next.t("tools.backup.import.partial", {
+					count: errors
+				}));
+			} else {
+				toaster.success(i18next.t("tools.backup.import.done"));
+			}
+			// reload the imported settings into the UI
+			socket.send('{"settings":{"settings":"settings"}}');
+			rebuildRFIDList();
+		}
+
 		async function cleanSd() {
 			$('#cleanSdModal').modal('hide');
 			toaster.info(i18next.t("files.clean.running"));

src/Web.cpp

@@ -2417,10 +2417,26 @@ void handleTrackProgressRequest(AsyncWebServerRequest *request) {
 }
 
 void handleGetSavedSSIDs(AsyncWebServerRequest *request) {
+	// optional parameter to include credentials & static-ip config (used for backups)
+	const bool withCredentials = request->hasParam("credentials");
 	AsyncJsonResponse *response = new AsyncJsonResponse(true);
 	JsonArray json_ssids = response->getRoot();
-	Wlan_GetSavedNetworks([json_ssids](const WiFiSettings &network) {
-		json_ssids.add(network.ssid);
+	Wlan_GetSavedNetworks([json_ssids, withCredentials](const WiFiSettings &network) {
+		if (!withCredentials) {
+			json_ssids.add(network.ssid);
+			return;
+		}
+		JsonObject entry = json_ssids.add<JsonObject>();
+		entry["ssid"] = network.ssid;
+		entry["pwd"] = network.password;
+		if (network.staticIp.isValid()) {
+			entry["static"] = true;
+			entry["static_addr"] = network.staticIp.addr.toString();
+			entry["static_subnet"] = network.staticIp.subnet.toString();
+			entry["static_gateway"] = network.staticIp.gateway.toString();
+			entry["static_dns1"] = network.staticIp.dns1.toString();
+			entry["static_dns2"] = network.staticIp.dns2.toString();
+		}
 	});
 
 	response->setLength();