@@ -135,7 +135,7 @@ neon logo that doubles as the SVG favicon ([`7be5254`](../../commit/7be5254)):
 | **HTTP file sync**: pull audio files from a web server (e.g. nginx) onto the SD card. A new **Sync** settings sub-tab takes a manifest URL plus optional HTTP Basic Auth (user/password); the device fetches a JSON manifest (`{"files":[{"path","size"},…]}`) and downloads every listed file that is missing locally or differs in size, streaming each in small chunks straight to SD. Additive only (never deletes), runs in a background task, and shows live progress including the file currently being downloaded plus a stop button to cancel a running sync. The **Sync** settings sub-tab holds the config (manifest URL + Basic Auth) and documents the manifest format/nginx setup; the actual run button and live progress live in the **Tools** tab, with a shortcut button in the Sync sub-tab that jumps there. If audio is playing when a sync starts, playback is paused for the SD-writing phase and resumes automatically when the sync finishes; pressing play (or skipping a track) cancels the running sync and resumes playback immediately. Any button press (or triggered command) also aborts a running sync — toggleable in the Sync settings sub-tab (default on). Reloading the web UI reconnects to a sync still running in the background instead of showing an idle state. A stalled download (connection open but no data for 20 s) is aborted and marked failed so one bad/slow file can't hang the whole sync. While a sync runs the NeoPixel indicator LEDs light solid blue (a single transmission while the LED task is paused, so there is no repeated refresh to starve WiFi/TLS). A running sync also keeps the device awake: since the sync runs in a background task and pauses playback, it no longer refreshes the activity timer on its own, so the inactivity timeout / sleep-timer is suppressed while a sync is in progress — preventing the device from going to deep-sleep mid-transfer (which would tear down the SD card and abort the sync); the timer resumes normally once the sync finishes | [`ac24bbc`](../../commit/ac24bbc) |
 | **Fully offline web interface**: all third-party libraries (jQuery, jQuery-UI, Bootstrap JS/CSS, jstree + themes, bootstrap-slider, Font Awesome + webfonts, i18next) and the Orbitron/Rajdhani/Share Tech Mono fonts are now vendored and served gzipped from the device instead of public CDNs. This fixes the ~2-minute first-load hang with empty (untranslated) text after a cold boot/flash, and makes the management UI work without any internet access (incl. AP mode). `processHtml.py` embeds the assets into flash (build size grows accordingly) and now derives unique header symbol names from the full asset path. The libs are concatenated into a single JS and a single CSS bundle (`tools/bundle_assets.py`) so the page makes only a handful of requests — many parallel requests to the ESP32's async web server made some browsers (Safari/Chrome) stall for minutes while Firefox coped | [`c618191`](../../commit/c618191) |
 | **M3U playlist builder**: a "Create playlist" button in the Files tab opens a two-pane builder — browse the SD card on the left, an ordered (drag-to-reorder) track list on the right — to assemble an `.m3u` from SD files, whole folders, and webradio URLs (which `LOCAL_M3U` plays interchangeably). Saving writes `/Playlists/<name>.m3u` via a new `POST /playlist` endpoint; the file can then be assigned to an RFID tag with play mode 11. i18n de/en/fr | [`af041fc`](../../commit/af041fc) |
-| **File browser: assignment badges + context-menu RFID learn**: in the Files-tab tree each row is badged (right-aligned, after the name) when that exact path has an **RFID tag** assigned (tag icon) and/or a **per-path EQ rule** (sliders icon), so you can see at a glance what is mapped where. The explorer **context menu** now also learns/removes RFID assignments directly: place a card (its id fills the field), then right-click a file/folder → **RFID** → pick a play mode to assign it to that card on the spot (no tab switch / submit), or **remove** an existing assignment. Mirrors the existing EQ-profile submenu. Badges refresh when a folder is (re)opened and live after assigning/removing. i18n de/en/fr | [`PENDING`](../../commit/PENDING) |
+| **File browser: assignment badges + context-menu RFID learn (scan-after-select)**: in the Files-tab tree each row is badged (right-aligned, after the name) when that exact path has an **RFID tag** assigned (tag icon) and/or a **per-path EQ rule** (sliders icon), so you can see at a glance what is mapped where. The explorer **context menu** learns/removes RFID assignments directly: right-click a file/folder → **RFID anlernen** → pick a play mode, then **lay the card** — the next scanned card is assigned to that path (no tab switch / submit); or **remove** an existing assignment. Mirrors the existing EQ-profile submenu. Works with physical cards and the [virtual cards](#virtual-rfid-cards) (`CMD_VIRTUAL_RFID_CARD_*`) alike. Badges refresh when a folder is (re)opened and live after assigning/removing. i18n de/en/fr | [`PENDING`](../../commit/PENDING) |
 | **OpenAPI/Swagger spec updated**: the bundled `REST_API.yaml` (served at `/swagger.html`) now documents all fork-added endpoints (`/sync`, `/syncstop`, `/playlist`, `/githubupdate`, `/version`, `/login`, `/logout`, `/security`, `/eqrule(s)`, `/activeequalizer`, `/bluetooth*`, `/sdclean`) and declares the security schemes (`X-API-Key` header / `apikey` query param, or the `ESPUINO_SESSION` login cookie) so the Swagger "Authorize" button works. The web-interface footer links to the Swagger UI (`/swagger.html`) | [`f8298d9`](../../commit/f8298d9) |
 
 #### Feature highlights
@@ -200,6 +200,28 @@ neon logo that doubles as the SVG favicon ([`7be5254`](../../commit/7be5254)):
 | Support for a 6th button | [`b116151`](../../commit/b116151) |
 | OLED display support (SH1106/SSD1306 128×64 over I2C): boot splash, idle screen with IP + READY, now-playing title (up to 3 lines, scrolling) with battery/time/wifi status bar, and a volume bar | [`8ce8104`](../../commit/8ce8104) |
 
+### Virtual RFID cards
+
+This is an existing ESPuino feature (not a fork addition) that is easy to miss, so it is documented
+here for clarity. Action-to-button assignment in general works as described in the upstream
+*"dynamic button layout"* documentation.
+
+**Normal card.** A physical RFID card has a fixed, pre-programmed number. When the card is placed on
+the reader the ESP32 reads that number (it is also pushed into the web interface). You then *learn*
+the card — i.e. you link its number to an action. The next time the card is placed, the ESP32 looks
+up that mapping in its flash and runs the matching action.
+
+**Virtual card.** You bind a button press (short or long) or a two-button combination to an action
+in `settings.h` as usual — but the actions `CMD_VIRTUAL_RFID_CARD_01` … `CMD_VIRTUAL_RFID_CARD_10`
+are special: they *simulate placing a card*. Running `CMD_VIRTUAL_RFID_CARD_01` is exactly the same
+as placing a physical card with the number `900000000001` (…`_10` → `900000000010`). You learn that
+number in the web interface like any normal card, and pressing the bound button then has the same
+effect as placing that card. The fixed ids live in [`src/values.h`](src/values.h) and are enqueued
+in [`src/Cmd.cpp`](src/Cmd.cpp). MQTT can lay the same ids via the `rfid` command topic.
+
+> Tip: to learn a (physical or virtual) card to a file/folder, right-click it in the file browser →
+> **RFID anlernen** → pick a play mode, then lay the card (or press the button bound to its virtual id).
+
 ## // Flashing
 
 ```bash
 
@@ -333,6 +333,11 @@
 					"249": "Spiele virtuelle RFID-Karte 09",
 					"250": "Spiele virtuelle RFID-Karte 10"
 				}
+			},
+			"learn": {
+				"waiting": "Bitte jetzt die RFID-Karte auflegen…",
+				"done": "Karte {{rfidId}} zugewiesen",
+				"timeout": "Anlernen abgebrochen (keine Karte aufgelegt)"
 			}
 		}
 	},
 
@@ -333,6 +333,11 @@
 					"249": "Play virtual RFID-card 09",
 					"250": "Play virtual RFID-card 10"
 				}
+			},
+			"learn": {
+				"waiting": "Now place the RFID card on the reader…",
+				"done": "Card {{rfidId}} assigned",
+				"timeout": "Learning cancelled (no card was placed)"
 			}
 		}
 	},
 
@@ -326,6 +326,11 @@
 					"249": "Lire la carte RFID virtuelle 09",
 					"250": "Lire la carte RFID virtuelle 10"
 				}
+			},
+			"learn": {
+				"waiting": "Posez maintenant la carte RFID sur le lecteur…",
+				"done": "Carte {{rfidId}} associée",
+				"timeout": "Apprentissage annulé (aucune carte posée)"
 			}
 		}
 	},
 
@@ -4027,33 +4027,23 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 							icon: "fas fa-sliders-h",
 							submenu: eqSubmenu
 						};
-						/* RFID: learn the currently scanned card onto this file/folder (pick a play
-						   mode = assign directly, no tab switch / submit) or remove its assignment. */
+						/* RFID: learn a card onto this file/folder. Pick a play mode -> the next card
+						   laid on the reader gets assigned to this path (scan-after-select flow). */
 						var rfidSubmenu = {};
-						var scannedId = document.getElementById('rfidIdMusic').value;
-						var hasCard = /^[0-9]{12}$/.test(scannedId || "");
-						if (hasCard) {
-							$('#playMode option').each(function () {
-								var cls = this.className || "";
-								var ok = node.data.directory
-									? /option-folder|option-file-and-folder/.test(cls)
-									: (node.type === "playlist"
-										? /option-file\b|option-file-and-folder|option-stream/.test(cls)
-										: /option-file\b|option-file-and-folder/.test(cls));
-								if (!ok) return;
-								var val = this.value, label = (this.textContent || "").trim() || ("Mode " + val);
-								rfidSubmenu["m" + val] = {
-									label: label,
-									action: (function (v) { return function () { assignRfidToPath(node.data.path, v, nodeId); }; })(val)
-								};
-							});
-						} else {
-							rfidSubmenu.nocard = {
-								label: () => i18next.t("files.context.rfidNoCard"),
-								_disabled: true,
-								action: function () { }
+						$('#playMode option').each(function () {
+							var cls = this.className || "";
+							var ok = node.data.directory
+								? /option-folder|option-file-and-folder/.test(cls)
+								: (node.type === "playlist"
+									? /option-file\b|option-file-and-folder|option-stream/.test(cls)
+									: /option-file\b|option-file-and-folder/.test(cls));
+							if (!ok) return;
+							var val = this.value, label = (this.textContent || "").trim() || ("Mode " + val);
+							rfidSubmenu["m" + val] = {
+								label: label,
+								action: (function (v) { return function () { armRfidLearn(node.data.path, v, nodeId); }; })(val)
 							};
-						}
+						});
 						if (hasRfidAssignment(node.data.path)) {
 							rfidSubmenu.remove = {
 								label: () => i18next.t("files.context.rfidRemove"),
@@ -4319,9 +4309,14 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 				console.log(socketMsg);
 				if (socketMsg.rfidId != null) {
 					document.getElementById('rfidIdMusic').value = socketMsg.rfidId;
-					toaster.info(i18next.t("toast.rfidDetect", {
-						rfidId: socketMsg.rfidId
-					}));
+					// If a "learn" was armed from the explorer context menu, complete it with this card.
+					if (pendingRfidLearn) {
+						completeRfidLearn(socketMsg.rfidId);
+					} else {
+						toaster.info(i18next.t("toast.rfidDetect", {
+							rfidId: socketMsg.rfidId
+						}));
+					}
 					$("#rfidIdMusic").effect("highlight", {
 						color: "#abf5af"
 					}, 3000);
@@ -6217,19 +6212,36 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 		}
 		// Assign the currently scanned RFID card to a file/folder path with the given play mode
 		// (the elegant path: triggered from the explorer context menu, no tab switch / submit).
-		async function assignRfidToPath(path, playMode, nodeId) {
-			var id = document.getElementById('rfidIdMusic').value;
-			if (!/^[0-9]{12}$/.test(id || "")) {
-				toaster.warning(i18next.t("files.context.rfidNoCard"));
-				return;
-			}
+		// Pending "learn" request: armed from the explorer context menu, completed by the next
+		// physically laid card. { path, playMode, nodeId, timer } or null.
+		var pendingRfidLearn = null;
+		// Arm learning: remember the target path + play mode, then wait for the next card scan.
+		function armRfidLearn(path, playMode, nodeId) {
+			if (pendingRfidLearn && pendingRfidLearn.timer) { clearTimeout(pendingRfidLearn.timer); }
+			pendingRfidLearn = {
+				path: path, playMode: String(playMode), nodeId: nodeId,
+				timer: setTimeout(function () {
+					pendingRfidLearn = null;
+					toaster.warning(i18next.t("files.rfid.learn.timeout"));
+				}, 60000)
+			};
+			toaster.info(i18next.t("files.rfid.learn.waiting"));
+		}
+		function cancelRfidLearn() {
+			if (pendingRfidLearn && pendingRfidLearn.timer) { clearTimeout(pendingRfidLearn.timer); }
+			pendingRfidLearn = null;
+		}
+		// Complete a pending learn with a just-scanned card id (called from the websocket handler).
+		async function completeRfidLearn(scannedId) {
+			var p = pendingRfidLearn;
+			cancelRfidLearn();
 			await fetch("http://" + host + "/settings", {
 				method: "POST",
 				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify({ rfidAssign: { rfidIdMusic: id, fileOrUrl: removeTrSlash(path), playMode: String(playMode) } })
+				body: JSON.stringify({ rfidAssign: { rfidIdMusic: scannedId, fileOrUrl: removeTrSlash(p.path), playMode: p.playMode } })
 			});
-			toaster.info(i18next.t("toast.saved"));
-			refreshRfidBadgesAround(nodeId);
+			toaster.info(i18next.t("files.rfid.learn.done", { rfidId: scannedId }));
+			refreshRfidBadgesAround(p.nodeId);
 		}
 		// Remove every RFID tag assigned to this exact path (usually one) straight from the explorer.
 		async function removeRfidForPath(path, nodeId) {
Original file line number	Diff line number	Diff line change
`@@ -333,6 +333,11 @@`
`333`	`333`	`"249": "Spiele virtuelle RFID-Karte 09",`
`334`	`334`	`"250": "Spiele virtuelle RFID-Karte 10"`
`335`	`335`	`}`
	`336`	`+ },`
	`337`	`+ "learn": {`
	`338`	`+ "waiting": "Bitte jetzt die RFID-Karte auflegen…",`
	`339`	`+ "done": "Karte {{rfidId}} zugewiesen",`
	`340`	`+ "timeout": "Anlernen abgebrochen (keine Karte aufgelegt)"`
`336`	`341`	`}`
`337`	`342`	`}`
`338`	`343`	`},`
Original file line number	Diff line number	Diff line change
`@@ -326,6 +326,11 @@`
`326`	`326`	`"249": "Lire la carte RFID virtuelle 09",`
`327`	`327`	`"250": "Lire la carte RFID virtuelle 10"`
`328`	`328`	`}`
	`329`	`+ },`
	`330`	`+ "learn": {`
	`331`	`+ "waiting": "Posez maintenant la carte RFID sur le lecteur…",`
	`332`	`+ "done": "Carte {{rfidId}} associée",`
	`333`	`+ "timeout": "Apprentissage annulé (aucune carte posée)"`
`329`	`334`	`}`
`330`	`335`	`}`
`331`	`336`	`},`