feat: selectable idle animation (standard or cyberpunk Data Drop)

Add an option in the LED settings to choose the idle animation between
the standard ESPuino idle dots and the cyberpunk 'Data Drop' animation.
Animation_Idle dispatches on a new gLedSettings.idleAnimation value
loaded from NVS (key 'idleAnim'); the standard idle dots logic is
restored for that path. Persisted via the web interface and exposed in
the settings JSON. Defaults to standard, so a freshly flashed device
starts with the standard animation.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: fhirschmann

README.md

@@ -99,6 +99,7 @@ neon logo that doubles as the SVG favicon ([`8d9725c`](../../commit/8d9725c)):
 | Configurable idle LED and progress bar colors | [`bdc54e5`](../../commit/bdc54e5) |
 | Ready sound on cold start | [`c051c40`](../../commit/c051c40) |
 | Cyberpunk "Data Drop" idle LED animation | [`f20b111`](../../commit/f20b111) |
+| Selectable idle animation (standard idle dots or cyberpunk "Data Drop") in the LED settings; defaults to standard | [`7174669`](../../commit/7174669) |
 | Improved button responsiveness and track navigation seek options | [`76e1535`](../../commit/76e1535) |
 | Unlocking controls via button press while locked | [`d83e15f`](../../commit/d83e15f) |
 | Support for a 6th button | [`b116151`](../../commit/b116151) |

html/locales/de.json

@@ -46,6 +46,11 @@
 			"controlled": "Kontroll-LED",
 			"numidledots": "Anzahl LEDs im Leerlauf",
 			"idlecolor": "Farbe der Leerlauf-LEDs",
+			"idleanimation": "Leerlauf-Animation",
+			"idleanim": {
+				"standard": "Standard",
+				"cyberpunk": "Cyberpunk (Data Drop)"
+			},
 			"progcolorstart": "Startfarbe Fortschrittsanzeige",
 			"progcolorend": "Endfarbe Fortschrittsanzeige",
 			"offsetpause": "Pausen-LEDs zentrieren",

html/locales/en.json

@@ -46,6 +46,11 @@
 			"controlled": "Control-LED",
 			"numidledots": "Number of LEDs in idle state",
 			"idlecolor": "Color of the idle dots",
+			"idleanimation": "Idle animation",
+			"idleanim": {
+				"standard": "Standard",
+				"cyberpunk": "Cyberpunk (Data Drop)"
+			},
 			"progcolorstart": "Start color of progress bar",
 			"progcolorend": "End color of progress bar",
 			"offsetpause": "Center pause LEDs",

html/locales/fr.json

@@ -46,6 +46,11 @@
 			"controlled": "LED de contrôle",
 			"numidledots": "Nombre de LED en état de veille",
 			"idlecolor": "Couleur des LED en veille",
+			"idleanimation": "Animation de veille",
+			"idleanim": {
+				"standard": "Standard",
+				"cyberpunk": "Cyberpunk (Data Drop)"
+			},
 			"progcolorstart": "Couleur de début du progrès",
 			"progcolorend": "Couleur de fin du progrès",
 			"offsetpause": "LED pause centre",

html/management.html

@@ -2246,6 +2246,11 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 									max="128"><br>
 								<label for="led_idleColor" data-i18n="settingsex.led.idlecolor"></label>: <br>
 								<input type="color" class="form-control" id="led_idleColor" name="led_idleColor"><br>
+								<label for="led_idleAnimation" data-i18n="settingsex.led.idleanimation"></label>: <br>
+								<select class="form-control form-select" id="led_idleAnimation" name="led_idleAnimation">
+									<option value="0" data-i18n="settingsex.led.idleanim.standard"></option>
+									<option value="1" data-i18n="settingsex.led.idleanim.cyberpunk"></option>
+								</select><br>
 								<label for="led_progColorStart" data-i18n="settingsex.led.progcolorstart"></label>: <br>
 								<input type="color" class="form-control" id="led_progColorStart" name="led_progColorStart"><br>
 								<label for="led_progColorEnd" data-i18n="settingsex.led.progcolorend"></label>: <br>
@@ -3755,6 +3760,7 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 				listControlColors(ledSettings.numControl, ledSettings.controlColors);
 				document.getElementById('led_idleDots').value = ledSettings.numIdleDots;
 				document.getElementById('led_idleColor').value = getHexColor(ledSettings.idleColor);
+				document.getElementById('led_idleAnimation').value = ledSettings.idleAnimation != null ? ledSettings.idleAnimation : 0;
 				document.getElementById('led_progColorStart').value = getHexColor(ledSettings.progColorStart);
 				document.getElementById('led_progColorEnd').value = getHexColor(ledSettings.progColorEnd);
 				$('#led_hueAtmo').bootstrapSlider('setValue', ledSettings.hueAtmo);
@@ -4181,6 +4187,7 @@ <h5 class="modal-title" data-i18n="tools.nvs.erase.title"></h5>
 					controlColors: [],
 					numIdleDots: Number(document.getElementById("led_idleDots").value),
 					idleColor: hexColorToInt(document.getElementById("led_idleColor").value),
+					idleAnimation: Number(document.getElementById("led_idleAnimation").value),
 					progColorStart: hexColorToInt(document.getElementById("led_progColorStart").value),
 					progColorEnd: hexColorToInt(document.getElementById("led_progColorEnd").value),
 					hueAtmo: Number($('#led_hueAtmo').val()),

src/Led.cpp

@@ -111,6 +111,10 @@ bool Led_LoadSettings(LedSettings &settings) {
 	// Get the idle color from NVS
 	settings.idleColor = gPrefsSettings.getUInt("idleColor", IDLE_COLOR);
 
+	// Get the idle animation style from NVS (0 = standard idle dots, 1 = cyberpunk "Data Drop").
+	// Defaults to standard so a freshly flashed device starts with the standard animation.
+	settings.idleAnimation = gPrefsSettings.getUChar("idleAnim", 0);
+
 	// Get offset LED pause from NVS
 	settings.offsetLedPause = gPrefsSettings.getBool("offsetPause", OFFSET_PAUSE_LEDS);
 
@@ -373,7 +377,7 @@ CRGB::HTMLColorCode Led_GetIdleColor() {
 		} else {
 			idleColor = CRGB::Green;
 			if (Wlan_IsConnected()) {
-				idleColor = (CRGB::HTMLColorCode)gLedSettings.idleColor;
+				idleColor = (CRGB::HTMLColorCode) gLedSettings.idleColor;
 			}
 		}
 	}
@@ -925,26 +929,48 @@ AnimationReturnType Animation_Rewind(const bool startNewAnimation, CRGBSet &leds
 // --------------------------------
 AnimationReturnType Animation_Idle(const bool startNewAnimation, CRGBSet &leds) {
 	// return values
-	int32_t animationDelay = 120;
+	int32_t animationDelay = 0;
 	bool animationActive = true;
 	bool animationRefresh = true;
 
-	// static vars
-	static int16_t step = 0;
-
-	if (startNewAnimation) {
-		step = 0;
-	}
-
-	CRGB idleColor = (CRGB)Led_GetIdleColor();
-
-	leds.fadeToBlackBy(40);
-	if (leds.size() > 0) {
-		int16_t idx = (leds.size() - 1) - (step % leds.size());
-		if (idx >= 0 && idx < leds.size()) {
-			leds[idx] = idleColor;
+	if (gLedSettings.idleAnimation == 1) {
+		// Cyberpunk "Data Drop": a single dot travels along the ring, leaving a fading trail
+		static int16_t step = 0;
+		if (startNewAnimation) {
+			step = 0;
+		}
+		CRGB idleColor = (CRGB) Led_GetIdleColor();
+		leds.fadeToBlackBy(40);
+		if (leds.size() > 0) {
+			int16_t idx = (leds.size() - 1) - (step % leds.size());
+			if (idx >= 0 && idx < leds.size()) {
+				leds[idx] = idleColor;
+			}
+			step = (step + 1) % leds.size();
+		}
+		animationDelay = 120;
+	} else {
+		// Standard ESPuino idle animation: evenly spaced idle dots rotating around the ring
+		static int16_t ledIndex = 0;
+		if (startNewAnimation) {
+			ledIndex = 0;
+		}
+		if (ledIndex < leds.size()) {
+			CRGB::HTMLColorCode idleColor = Led_GetIdleColor();
+			leds = CRGB::Black;
+			Led_DrawIdleDots(leds, ledIndex, idleColor);
+			if (OPMODE_BLUETOOTH_SOURCE == System_GetOperationMode()) {
+				// animate a bit faster in BT-Source to distinguish between the bluetooth modes
+				animationDelay = 30 * 10;
+			} else {
+				animationDelay = 50 * 10;
+			}
+			ledIndex++;
+		} else {
+			animationActive = false;
+			animationRefresh = false;
+			ledIndex = 0;
 		}
-		step = (step + 1) % leds.size();
 	}
 
 	return AnimationReturnType(animationActive, animationDelay, animationRefresh);
@@ -1037,7 +1063,7 @@ AnimationReturnType Animation_Progress(const bool startNewAnimation, CRGBSet &le
 		lastPos = gPlayProperties.currentRelPos;
 		leds = CRGB::Black;
 		if (gLedSettings.numIndicatorLeds == 1) {
-			leds[0] = blend((CRGB)gLedSettings.progressColorStart, (CRGB)gLedSettings.progressColorEnd, (uint8_t)(gPlayProperties.currentRelPos * 255 / 100));
+			leds[0] = blend((CRGB) gLedSettings.progressColorStart, (CRGB) gLedSettings.progressColorEnd, (uint8_t) (gPlayProperties.currentRelPos * 255 / 100));
 		} else {
 			const uint32_t ledValue = std::clamp<uint32_t>(map(gPlayProperties.currentRelPos, 0, 98, 0, leds.size() * gLedSettings.dimmableStates), 0, leds.size() * gLedSettings.dimmableStates);
 			const uint8_t fullLeds = ledValue / gLedSettings.dimmableStates;
@@ -1046,14 +1072,14 @@ AnimationReturnType Animation_Progress(const bool startNewAnimation, CRGBSet &le
 				if (System_AreControlsLocked()) {
 					leds[Led_Address(led)] = CRGB::Red;
 				} else if (!gPlayProperties.pausePlay) {
-					leds[Led_Address(led)] = blend((CRGB)gLedSettings.progressColorStart, (CRGB)gLedSettings.progressColorEnd, (led * 255) / (leds.size() - 1));
+					leds[Led_Address(led)] = blend((CRGB) gLedSettings.progressColorStart, (CRGB) gLedSettings.progressColorEnd, (led * 255) / (leds.size() - 1));
 				}
 			}
 			if (lastLed > 0) {
 				if (System_AreControlsLocked()) {
 					leds[Led_Address(fullLeds)] = CRGB::Red;
 				} else {
-					leds[Led_Address(fullLeds)] = blend((CRGB)gLedSettings.progressColorStart, (CRGB)gLedSettings.progressColorEnd, (fullLeds * 255) / (leds.size() - 1));
+					leds[Led_Address(fullLeds)] = blend((CRGB) gLedSettings.progressColorStart, (CRGB) gLedSettings.progressColorEnd, (fullLeds * 255) / (leds.size() - 1));
 				}
 				leds[Led_Address(fullLeds)] = Led_DimColor(leds[Led_Address(fullLeds)], lastLed);
 			}

src/Led.h

@@ -47,40 +47,41 @@ typedef struct {
 
 	#include <FastLED.h>
 
-	enum class LedPlaylistProgressStates : uint8_t {
-		FillBar = 0,
-		Wait,
-		EmptyBar,
-		EmptyBarToTarget,
-		Done
-	};
+enum class LedPlaylistProgressStates : uint8_t {
+	FillBar = 0,
+	Wait,
+	EmptyBar,
+	EmptyBarToTarget,
+	Done
+};
 
-	struct LedSettings {
-		uint8_t numIndicatorLeds = NUM_INDICATOR_LEDS;
-		uint8_t numControlLeds = NUM_CONTROL_LEDS;
-		std::vector<uint32_t> controlLedColors;
-		uint8_t numIdleDots = NUM_LEDS_IDLE_DOTS;
-		uint32_t idleColor = IDLE_COLOR;
-		bool offsetLedPause = OFFSET_PAUSE_LEDS;
-		uint32_t progressColorStart = PROGRESS_COLOR_START;
-		uint32_t progressColorEnd = PROGRESS_COLOR_END;
-		int16_t atmoHue = ATMO_HUE;
-		int16_t atmoSaturation = ATMO_SATURATION;
-		uint8_t dimmableStates = DIMMABLE_STATES;
-		bool neopixelReverseRotation;
-		uint8_t ledOffset;
-		bool Led_Pause;
+struct LedSettings {
+	uint8_t numIndicatorLeds = NUM_INDICATOR_LEDS;
+	uint8_t numControlLeds = NUM_CONTROL_LEDS;
+	std::vector<uint32_t> controlLedColors;
+	uint8_t numIdleDots = NUM_LEDS_IDLE_DOTS;
+	uint32_t idleColor = IDLE_COLOR;
+	uint8_t idleAnimation = 0; // 0 = standard idle dots, 1 = cyberpunk "Data Drop"
+	bool offsetLedPause = OFFSET_PAUSE_LEDS;
+	uint32_t progressColorStart = PROGRESS_COLOR_START;
+	uint32_t progressColorEnd = PROGRESS_COLOR_END;
+	int16_t atmoHue = ATMO_HUE;
+	int16_t atmoSaturation = ATMO_SATURATION;
+	uint8_t dimmableStates = DIMMABLE_STATES;
+	bool neopixelReverseRotation;
+	uint8_t ledOffset;
+	bool Led_Pause;
 
-		bool Led_NightMode = false;
-		bool Led_AmbientLight = false;
-		uint8_t Led_InitialBrightness = LED_INITIAL_BRIGHTNESS;
-		uint8_t Led_Brightness = LED_INITIAL_BRIGHTNESS;
-		uint8_t Led_NightBrightness = LED_INITIAL_NIGHT_BRIGHTNESS;
-		uint8_t Led_AmbientBrightness = LED_INITIAL_BRIGHTNESS;
-	};
+	bool Led_NightMode = false;
+	bool Led_AmbientLight = false;
+	uint8_t Led_InitialBrightness = LED_INITIAL_BRIGHTNESS;
+	uint8_t Led_Brightness = LED_INITIAL_BRIGHTNESS;
+	uint8_t Led_NightBrightness = LED_INITIAL_NIGHT_BRIGHTNESS;
+	uint8_t Led_AmbientBrightness = LED_INITIAL_BRIGHTNESS;
+};
 
-	bool Led_GetNightmode();
-	bool Led_GetAmbientLight();
+bool Led_GetNightmode();
+bool Led_GetAmbientLight();
 #endif
 
 void Led_Init(void);

src/Web.cpp

@@ -949,6 +949,7 @@ WebsocketCodeType JSONToSettings(JsonObject doc) {
 		success = success && (gPrefsSettings.putUChar("numControl", ledObj["numControl"].as<uint8_t>()) != 0);
 		success = success && (gPrefsSettings.putUChar("numIdleDots", ledObj["numIdleDots"].as<uint8_t>()) != 0);
 		success = success && (gPrefsSettings.putUInt("idleColor", ledObj["idleColor"].as<uint32_t>()) != 0);
+		success = success && (gPrefsSettings.putUChar("idleAnim", ledObj["idleAnimation"].as<uint8_t>()) != 0);
 		success = success && (gPrefsSettings.putBool("offsetPause", ledObj["offsetPause"].as<bool>()) != 0);
 		success = success && (gPrefsSettings.putUInt("progColorStart", ledObj["progColorStart"].as<uint32_t>()) != 0);
 		success = success && (gPrefsSettings.putUInt("progColorEnd", ledObj["progColorEnd"].as<uint32_t>()) != 0);
@@ -1308,6 +1309,7 @@ static void settingsToJSON(JsonObject obj, const String section) {
 		}
 		ledObj["numIdleDots"].set(gPrefsSettings.getUChar("numIdleDots", NUM_LEDS_IDLE_DOTS));
 		ledObj["idleColor"].set(gPrefsSettings.getUInt("idleColor", IDLE_COLOR));
+		ledObj["idleAnimation"].set(gPrefsSettings.getUChar("idleAnim", 0));
 		ledObj["offsetPause"].set(gPrefsSettings.getBool("offsetPause", OFFSET_PAUSE_LEDS));
 		ledObj["progColorStart"].set(gPrefsSettings.getUInt("progColorStart", PROGRESS_COLOR_START));
 		ledObj["progColorEnd"].set(gPrefsSettings.getUInt("progColorEnd", PROGRESS_COLOR_END));
@@ -1418,6 +1420,7 @@ static void settingsToJSON(JsonObject obj, const String section) {
 		ledSettings["numControl"].set(NUM_CONTROL_LEDS); // NUM_CONTROL_LEDS
 		ledSettings["numIdleDots"].set(NUM_LEDS_IDLE_DOTS); // NUM_LEDS_IDLE_DOTS
 		ledSettings["idleColor"].set(IDLE_COLOR); // IDLE_COLOR
+		ledSettings["idleAnimation"].set(0u); // standard idle animation
 		ledSettings["offsetPause"].set(OFFSET_PAUSE_LEDS); // OFFSET_PAUSE_LEDS
 		ledSettings["progColorStart"].set(PROGRESS_COLOR_START); // PROGRESS_COLOR_START
 		ledSettings["progColorEnd"].set(PROGRESS_COLOR_END); // PROGRESS_COLOR_END