Refactor seasonal plugin configurations to improve clarity and consistency

- Updated comments for clarity on enabling/disabling features across various seasonal scripts.
- Changed default value checks to ensure undefined values are handled consistently.
- Enhanced readability by providing descriptive comments for configuration variables.

[skip ci]

Jellyfin.Plugin.Seasonals/Configuration/PluginConfiguration.cs

@@ -247,7 +247,7 @@ public class OktoberfestOptions {
 public class OlympiaOptions {
     public bool EnableOlympia { get; set; } = true;
     public int SymbolCount { get; set; } = 25;
-    public bool SymbolCountMobile { get; set; } = 10;
+    public int SymbolCountMobile { get; set; } = 10;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
@@ -323,7 +323,7 @@ public class SpaceOptions {
     public int IssCount { get; set; } = 1;
     public int RocketCount { get; set; } = 1;
     public bool EnableDifferentDuration { get; set; } = true;
-    public bool SymbolCountMobile { get; set; } = 2;
+    public int SymbolCountMobile { get; set; } = 2;
 }
 
 public class SpookyOptions {
@@ -354,7 +354,7 @@ public class SpringOptions {
     public int ButterflyCount { get; set; } = 4;
     public int BeeCount { get; set; } = 2;
     public int LadybugCount { get; set; } = 2;
-    public bool SymbolCountMobile { get; set; } = 2;
+    public int SymbolCountMobile { get; set; } = 2;
 }
 
 public class StarWarsOptions {
@@ -373,13 +373,13 @@ public class SummerOptions {
     public bool EnableSummer { get; set; } = true;
     public int BubbleCount { get; set; } = 30;
     public int DustCount { get; set; } = 50;
-    public bool SymbolCountMobile { get; set; } = 2;
+    public int SymbolCountMobile { get; set; } = 2;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
 public class UnderwaterOptions {
     public bool EnableUnderwater { get; set; } = true;
-    public bool SymbolCountMobile { get; set; } = 2;
+    public int SymbolCountMobile { get; set; } = 2;
     public bool EnableDifferentDuration { get; set; } = true;
     public bool EnableLightRays { get; set; } = true;
     public int SeaweedCount { get; set; } = 50;

Jellyfin.Plugin.Seasonals/Web/autumn.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Autumn || {};
 
-const leaves = config.EnableAutumn !== undefined ? config.EnableAutumn : true; // enable/disable leaves
+const leaves = config.EnableAutumn !== undefined ? config.EnableAutumn : true; // enable/disable autumn
 const randomLeaves = config.EnableRandomLeaves !== undefined ? config.EnableRandomLeaves : true; // enable random leaves
-const randomLeavesMobile = config.EnableRandomLeavesMobile !== undefined ? config.EnableRandomLeavesMobile : false; // enable random leaves on mobile devices (Warning: High values may affect performance)
+const randomLeavesMobile = config.EnableRandomLeavesMobile !== undefined ? config.EnableRandomLeavesMobile : false; // enable random leaves on mobile
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random leaves
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableRotation = config.EnableRotation !== undefined ? config.EnableRotation : false; // enable/disable leaf rotation
+const enableRotation = config.EnableRotation !== undefined ? config.EnableRotation : false; // enable/disable rotation
-const leafCount = config.LeafCount || 25; // count of random extra leaves
+const leafCount = config.LeafCount !== undefined ? config.LeafCount : 25; // count of random extra leaves
 
 const images = [
   "../Seasonals/Resources/autumn_images/acorn1.png",

Jellyfin.Plugin.Seasonals/Web/carnival.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Carnival || {};
 
-const carnival = config.EnableCarnival !== undefined ? config.EnableCarnival : true; // Enable/disable carnival
+const carnival = config.EnableCarnival !== undefined ? config.EnableCarnival : true; // enable/disable carnival
-const randomCarnival = config.EnableRandomCarnival !== undefined ? config.EnableRandomCarnival : true; // Enable random carnival objects
+const randomCarnival = config.EnableRandomCarnival !== undefined ? config.EnableRandomCarnival : true; // enable random carnival
-const randomCarnivalMobile = config.EnableRandomCarnivalMobile !== undefined ? config.EnableRandomCarnivalMobile : false; // Enable random carnival objects on mobile
+const randomCarnivalMobile = config.EnableRandomCarnivalMobile !== undefined ? config.EnableRandomCarnivalMobile : false; // enable random carnival on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // Randomize falling and flutter speeds
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableSway = config.EnableCarnivalSway !== undefined ? config.EnableCarnivalSway : true; // Enable side-to-side sway animation
+const enableSway = config.EnableCarnivalSway !== undefined ? config.EnableCarnivalSway : true; // enable/disable carnivalsway
-const carnivalCount = config.ObjectCount || 120; // Number of confetti pieces to spawn
+const carnivalCount = config.ObjectCount !== undefined ? config.ObjectCount : 120; // Number of confetti pieces to spawn
 
 const confettiColors = [
     '#fce18a', '#ff726d', '#b48def', '#f4306d', 

Jellyfin.Plugin.Seasonals/Web/cherryblossom.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.CherryBlossom || {};
 
-const cherryBlossom = config.EnableCherryBlossom !== undefined ? config.EnableCherryBlossom : true;
+const cherryBlossom = config.EnableCherryBlossom !== undefined ? config.EnableCherryBlossom : true; // enable/disable cherryblossom
-const petalCount = config.PetalCount || 25;
+const petalCount = config.PetalCount !== undefined ? config.PetalCount : 25; // count of petal
-const randomCherryBlossom = config.EnableRandomCherryBlossom !== undefined ? config.EnableRandomCherryBlossom : true;
+const randomCherryBlossom = config.EnableRandomCherryBlossom !== undefined ? config.EnableRandomCherryBlossom : true; // enable random cherryblossom
-const randomCherryBlossomMobile = config.EnableRandomCherryBlossomMobile !== undefined ? config.EnableRandomCherryBlossomMobile : false;
+const randomCherryBlossomMobile = config.EnableRandomCherryBlossomMobile !== undefined ? config.EnableRandomCherryBlossomMobile : false; // enable random cherryblossom on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/christmas.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Christmas || {};
 
 const christmas = config.EnableChristmas !== undefined ? config.EnableChristmas : true; // enable/disable christmas
-const randomChristmas = config.EnableRandomChristmas !== undefined ? config.EnableRandomChristmas : true; // enable random Christmas
+const randomChristmas = config.EnableRandomChristmas !== undefined ? config.EnableRandomChristmas : true; // enable random christmas
-const randomChristmasMobile = config.EnableRandomChristmasMobile !== undefined ? config.EnableRandomChristmasMobile : false; // enable random Christmas on mobile devices (Warning: High values may affect performance)
+const randomChristmasMobile = config.EnableRandomChristmasMobile !== undefined ? config.EnableRandomChristmasMobile : false; // enable random christmas on mobile
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random Christmas symbols
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const christmasCount = config.SymbolCount || 25; // count of random extra christmas
+const christmasCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbol
 
 // Array of christmas characters
 const christmasSymbols = ['❆', '🎁', '❄️', '🎁', '🎅', '🎊', '🎁', '🎉'];

Jellyfin.Plugin.Seasonals/Web/earthday.js

@@ -1,7 +1,7 @@
 const config = window.SeasonalsPluginConfig?.EarthDay || {};
 
-const enabled = config.EnableEarthDay !== undefined ? config.EnableEarthDay : true;
+const enabled = config.EnableEarthDay !== undefined ? config.EnableEarthDay : true; // enable/disable earthday
-const vineCount = config.VineCount || 4;
+const vineCount = config.VineCount !== undefined ? config.VineCount : 4; // count of vine
 
 const flowerColors = ['#FF69B4', '#FFD700', '#87CEFA', '#FF4500', '#BA55D3', '#FFA500', '#FF1493'];
 

Jellyfin.Plugin.Seasonals/Web/easter.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Easter || {};
 
-const easter = config.EnableEaster !== undefined ? config.EnableEaster : true;
+const easter = config.EnableEaster !== undefined ? config.EnableEaster : true; // enable/disable easter
-const enableBunny = config.EnableBunny !== undefined ? config.EnableBunny : true;
+const enableBunny = config.EnableBunny !== undefined ? config.EnableBunny : true; // enable/disable bunny
-const minBunnyRestTime = config.MinBunnyRestTime || 2000;
+const minBunnyRestTime = config.MinBunnyRestTime !== undefined ? config.MinBunnyRestTime : 2000; // timing parameter
-const maxBunnyRestTime = config.MaxBunnyRestTime || 5000;
+const maxBunnyRestTime = config.MaxBunnyRestTime !== undefined ? config.MaxBunnyRestTime : 5000; // timing parameter
-const eggCount = config.EggCount || 15;
+const eggCount = config.EggCount !== undefined ? config.EggCount : 15; // count of egg
 
 /* MARK: Bunny movement config */
 const jumpDistanceVw = 5; // Distance in vw the bunny covers per jump

Jellyfin.Plugin.Seasonals/Web/eid.js

@@ -1,5 +1,7 @@
 const config = window.SeasonalsPluginConfig?.Eid || {};
-const eid = config.EnableEid !== undefined ? config.EnableEid : true;
+const eid = config.EnableEid !== undefined ? config.EnableEid : true; // enable/disable eid
+const lanternCount = config.LanternCount !== undefined ? config.LanternCount : 8; // count of lantern
+const lanternCountMobile = config.LanternCountMobile !== undefined ? config.LanternCountMobile : 3; // count of lantern on mobile
 
 const eidSymbols = ['🌙', '⭐', '✨'];
 
@@ -39,11 +41,13 @@ observer.observe(document.body, {
 
 function createEid(container) {
     const starCount = 20;
-    const lanternCount = Math.floor(Math.random() * 3) + 4; // 4 to 6 lanterns
+    
+    let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
+    let activeLanternCount = isMobile ? lanternCountMobile : lanternCount;
 
     // Create evenly spaced lanterns
-    const segmentWidth = 100 / lanternCount;
+    const segmentWidth = 100 / activeLanternCount;
-    for (let i = 0; i < lanternCount; i++) {
+    for (let i = 0; i < activeLanternCount; i++) {
         const symbol = document.createElement('div');
         symbol.className = 'eid-symbol lantern-rope';
         

Jellyfin.Plugin.Seasonals/Web/eurovision.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Eurovision || {};
 
-const enabled = config.EnableEurovision !== undefined ? config.EnableEurovision : true;
+const enabled = config.EnableEurovision !== undefined ? config.EnableEurovision : true; // enable/disable eurovision
-const elementCount = config.SymbolCount || 25;
+const elementCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of notes
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableColorfulNotes = config.EnableColorfulNotes !== undefined ? config.EnableColorfulNotes : true;
+const enableColorfulNotes = config.EnableColorfulNotes !== undefined ? config.EnableColorfulNotes : true; // enable/disable colorful notes
-const eurovisionColorsStr = config.EurovisionColors || '#ff0026ff, #17a6ffff, #32d432ff, #FFD700, #f0821bff, #f826f8ff';
+const eurovisionColorsStr = config.EurovisionColors !== undefined ? config.EurovisionColors : '#ff0026ff, #17a6ffff, #32d432ff, #FFD700, #f0821bff, #f826f8ff'; // colors to use
-const glowSize = config.EurovisionGlowSize !== undefined ? config.EurovisionGlowSize : 2;
+const glowSize = config.EurovisionGlowSize !== undefined ? config.EurovisionGlowSize : 2; // size of eurovision glow
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/filmnoir.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.FilmNoir || {};
-const filmnoir = config.EnableFilmNoir !== undefined ? config.EnableFilmNoir : true;
+const filmnoir = config.EnableFilmNoir !== undefined ? config.EnableFilmNoir : true; // enable/disable filmnoir
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/fireworks.js

@@ -2,10 +2,10 @@ const config = window.SeasonalsPluginConfig?.Fireworks || {};
 
 const fireworks = config.EnableFireworks !== undefined ? config.EnableFireworks : true; // enable/disable fireworks
 const scrollFireworks = config.ScrollFireworks !== undefined ? config.ScrollFireworks : true; // enable fireworks to scroll with page content
-const particlesPerFirework = config.ParticleCount || 50; // count of particles per firework (Warning: High values may affect performance)
+const particlesPerFirework = config.ParticleCount !== undefined ? config.ParticleCount : 50; // count of particles per firework
-const minFireworks = config.MinFireworks || 3; // minimum number of simultaneous fireworks
+const minFireworks = config.MinFireworks !== undefined ? config.MinFireworks : 3; // minimum number of simultaneous fireworks
-const maxFireworks = config.MaxFireworks || 6; // maximum number of simultaneous fireworks
+const maxFireworks = config.MaxFireworks !== undefined ? config.MaxFireworks : 6; // maximum number of simultaneous fireworks
-const intervalOfFireworks = config.LaunchInterval || 3200; // interval for the fireworks in milliseconds
+const intervalOfFireworks = config.LaunchInterval !== undefined ? config.LaunchInterval : 3200; // interval for the fireworks in milliseconds
 
 // array of color palettes for the fireworks
 const colorPalettes = [

Jellyfin.Plugin.Seasonals/Web/friday13.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.Friday13 || {};
-const friday13 = config.EnableFriday13 !== undefined ? config.EnableFriday13 : true;
+const friday13 = config.EnableFriday13 !== undefined ? config.EnableFriday13 : true; // enable/disable friday13
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/frost.js

@@ -1,6 +1,6 @@
 const config = window.SeasonalsPluginConfig?.Frost || {};
 
-const frost = config.EnableFrost !== undefined ? config.EnableFrost : true;
+const frost = config.EnableFrost !== undefined ? config.EnableFrost : true; // enable/disable frost
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/hearts.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Hearts || {};
 
 const hearts = config.EnableHearts !== undefined ? config.EnableHearts : true; // enable/disable hearts
-const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable more random symbols
+const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable random symbols
-const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile devices (Warning: High values may affect performance)
+const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration for random symbols
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const heartsCount = config.SymbolCount || 25; // count of random extra symbols
+const heartsCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbol
 
 // Array of hearts characters
 const heartSymbols = ['❤️', '💕', '💞', '💓', '💗', '💖'];

Jellyfin.Plugin.Seasonals/Web/matrix.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Matrix || {};
 
-const enabled = config.EnableMatrix !== undefined ? config.EnableMatrix : true;
+const enabled = config.EnableMatrix !== undefined ? config.EnableMatrix : true; // enable/disable matrix
-const maxTrails = config.SymbolCount || 25; 
+const maxTrails = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of max trails on screen
-const backgroundMode = config.EnableMatrixBackground !== undefined ? config.EnableMatrixBackground : false;
+const backgroundMode = config.EnableMatrixBackground !== undefined ? config.EnableMatrixBackground : false; // enable/disable matrix as background
-const matrixChars = config.MatrixChars || '0123456789';
+const matrixChars = config.MatrixChars !== undefined ? config.MatrixChars : '0123456789'; // characters to use in the matrix rain, default is '0123456789'
 
 let msgPrinted = false;
 let isHidden = false;

Jellyfin.Plugin.Seasonals/Web/oktoberfest.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.Oktoberfest || {};
-const oktoberfest = config.EnableOktoberfest !== undefined ? config.EnableOktoberfest : true;
+const oktoberfest = config.EnableOktoberfest !== undefined ? config.EnableOktoberfest : true; // enable/disable oktoberfest
 
 const oktoberfestSymbols = ['🥨', '🍺', '🍻', '🥨', '🥨'];
 

Jellyfin.Plugin.Seasonals/Web/oscar.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.Oscar || {};
-const oscar = config.EnableOscar !== undefined ? config.EnableOscar : true;
+const oscar = config.EnableOscar !== undefined ? config.EnableOscar : true; // enable/disable oscar
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/pride.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Pride || {};
 
-const enabled = config.EnablePride !== undefined ? config.EnablePride : true;
+const enabled = config.EnablePride !== undefined ? config.EnablePride : true; // enable/disable pride
-const elementCount = config.HeartCount || 20;
+const elementCount = config.HeartCount !== undefined ? config.HeartCount : 20; // count of heart
-const heartSize = config.HeartSize || 1.5;
+const heartSize = config.HeartSize !== undefined ? config.HeartSize : 1.5; // size of hearts
-const colorHeader = config.ColorHeader !== undefined ? config.ColorHeader : true;
+const colorHeader = config.ColorHeader !== undefined ? config.ColorHeader : true; // optionally color the header with pride colors
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/rain.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Rain || {};
 
-const enabled = config.EnableRain !== undefined ? config.EnableRain : true;
+const enabled = config.EnableRain !== undefined ? config.EnableRain : true; // enable/disable rain
 const isMobile = window.innerWidth <= 768;
-const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300);
+const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300); // count of raindrops
-const rainSpeed = config.RainSpeed || 1.0;
+const rainSpeed = config.RainSpeed !== undefined ? config.RainSpeed : 1.0; // speed of rain
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/resurrection.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Resurrection || {};
 
-const enableResurrection = config.EnableResurrection !== undefined ? config.EnableResurrection : true;
+const enableResurrection = config.EnableResurrection !== undefined ? config.EnableResurrection : true; // enable/disable resurrection
-const enableRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
+const enableRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable random symbols
-const enableRandomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
+const enableRandomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const symbolCount = config.SymbolCount || 12;
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 12; // count of symbols
 
 let animationEnabled = true;
 let statusLogged = false;

Jellyfin.Plugin.Seasonals/Web/santa.js

@@ -1,15 +1,15 @@
 const config = window.SeasonalsPluginConfig?.Santa || {};
 
 const santaIsFlying = config.EnableSanta !== undefined ? config.EnableSanta : true; // enable/disable santa
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
-const snowFallSpeed = config.SnowFallSpeed || 3; // speed of snowfall	(recommended values: 0-5)
+const snowFallSpeed = config.SnowFallSpeed !== undefined ? config.SnowFallSpeed : 3; // speed of snowfall
-const santaSpeed = config.SantaSpeed || 10; // speed of santa in seconds (recommended values: 5-15)
+const santaSpeed = config.SantaSpeed !== undefined ? config.SantaSpeed : 10; // speed of santa in seconds
-const santaSpeedMobile = config.SantaSpeedMobile || 8; // speed of santa on mobile devices in seconds
+const santaSpeedMobile = config.SantaSpeedMobile !== undefined ? config.SantaSpeedMobile : 8; // speed of santa on mobile devices in seconds
-const maxSantaRestTime = config.MaxSantaRestTime || 8; // maximum time santa rests in seconds
+const maxSantaRestTime = config.MaxSantaRestTime !== undefined ? config.MaxSantaRestTime : 8; // maximum time santa rests in seconds
-const minSantaRestTime = config.MinSantaRestTime || 3; // minimum time santa rests in seconds
+const minSantaRestTime = config.MinSantaRestTime !== undefined ? config.MinSantaRestTime : 3; // minimum time santa rests in seconds
-const maxPresentFallSpeed = config.MaxPresentFallSpeed || 5; // maximum speed of falling presents in seconds
+const maxPresentFallSpeed = config.MaxPresentFallSpeed !== undefined ? config.MaxPresentFallSpeed : 5; // maximum speed of falling presents in seconds
-const minPresentFallSpeed = config.MinPresentFallSpeed || 2; // minimum speed of falling presents in seconds
+const minPresentFallSpeed = config.MinPresentFallSpeed !== undefined ? config.MinPresentFallSpeed : 2; // minimum speed of falling presents in seconds
 
 // credits: flaticon.com
 const presentImages = [

Jellyfin.Plugin.Seasonals/Web/snowfall.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Snowfall || {};
 
 const snowfall = config.EnableSnowfall !== undefined ? config.EnableSnowfall : true; // enable/disable snowfall
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
-const snowFallSpeed = config.Speed || 3; // speed of snowfall	(recommended values: 0-5)
+const snowFallSpeed = config.Speed !== undefined ? config.Speed : 3; // speed of snowfall
 
 let msgPrinted = false; // flag to prevent multiple console messages
 

Jellyfin.Plugin.Seasonals/Web/snowflakes.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Snowflakes || {};
 
 const snowflakes = config.EnableSnowflakes !== undefined ? config.EnableSnowflakes : true; // enable/disable snowflakes
-const snowflakeCount = config.SnowflakeCount || 25; // count of random extra snowflakes
+const snowflakeCount = config.SnowflakeCount !== undefined ? config.SnowflakeCount : 25; // count of snowflakes
-const randomSnowflakes = config.EnableRandomSnowflakes !== undefined ? config.EnableRandomSnowflakes : true; // enable random Snowflakes
+const randomSnowflakes = config.EnableRandomSnowflakes !== undefined ? config.EnableRandomSnowflakes : true; // enable random snowflakes
-const randomSnowflakesMobile = config.EnableRandomSnowflakesMobile !== undefined ? config.EnableRandomSnowflakesMobile : false; // enable random Snowflakes on mobile devices
+const randomSnowflakesMobile = config.EnableRandomSnowflakesMobile !== undefined ? config.EnableRandomSnowflakesMobile : false; // enable random snowflakes on mobile
-const enableColoredSnowflakes = config.EnableColoredSnowflakes !== undefined ? config.EnableColoredSnowflakes : true; // enable colored snowflakes
+const enableColoredSnowflakes = config.EnableColoredSnowflakes !== undefined ? config.EnableColoredSnowflakes : true; // enable/disable colored snowflakes
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 const snowflakeSymbols = ['❅', '❆']; // some snowflake symbols
 const snowflakeSymbolsMobile = ['❅', '❆', '❄']; // some snowflake symbols mobile version

Jellyfin.Plugin.Seasonals/Web/snowstorm.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Snowstorm || {};
 
 const snowstorm = config.EnableSnowstorm !== undefined ? config.EnableSnowstorm : true; // enable/disable snowstorm
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
-const snowFallSpeed = config.Speed || 6; // speed of snowfall	(recommended values: 4-8)
+const snowFallSpeed = config.Speed !== undefined ? config.Speed : 6; // speed of snowstorm
-const horizontalWind = config.HorizontalWind || 4; // horizontal wind speed (recommended value: 4)
+const horizontalWind = config.HorizontalWind !== undefined ? config.HorizontalWind : 4; // horizontal wind strength
-const verticalVariation = config.VerticalVariation || 2; // vertical variation (recommended value: 2)
+const verticalVariation = config.VerticalVariation !== undefined ? config.VerticalVariation : 2; // vertical variation
 
 let msgPrinted = false; // flag to prevent multiple console messages
 

Jellyfin.Plugin.Seasonals/Web/space.js

@@ -1,18 +1,20 @@
 const config = window.SeasonalsPluginConfig?.Space || {};
 
-const space = config.EnableSpace !== undefined ? config.EnableSpace : true;
+const space = config.EnableSpace !== undefined ? config.EnableSpace : true; // enable/disable space
-const planetCountConf = config.PlanetCount !== undefined ? config.PlanetCount : 6;
+const planetCountConf = config.PlanetCount !== undefined ? config.PlanetCount : 6; // count of planets
-const astronautCountConf = config.AstronautCount !== undefined ? config.AstronautCount : 1;
+const astronautCountConf = config.AstronautCount !== undefined ? config.AstronautCount : 1; // count of astronaut
-const satelliteCountConf = config.SatelliteCount !== undefined ? config.SatelliteCount : 4;
+const satelliteCountConf = config.SatelliteCount !== undefined ? config.SatelliteCount : 4; // count of satellite
-const issCountConf = config.IssCount !== undefined ? config.IssCount : 1;
+const issCountConf = config.IssCount !== undefined ? config.IssCount : 1; // count of iss
-const rocketCountConf = config.RocketCount !== undefined ? config.RocketCount : 1;
+const rocketCountConf = config.RocketCount !== undefined ? config.RocketCount : 1; // count of rocket/space shuttle
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
 
+// Credit: https://lottiefiles.com/free-animation/astronaut-63lcWG4Xnh
 const astronautImages = [
     "../Seasonals/Resources/space_assets/astronaut_1.gif"
 ];
+
+// Credits: https://flaticon.com
 const planetImages = [
     "../Seasonals/Resources/space_assets/planet_1.png",
     "../Seasonals/Resources/space_assets/planet_2.png",
@@ -24,13 +26,21 @@ const planetImages = [
     "../Seasonals/Resources/space_assets/planet_8.png",
     "../Seasonals/Resources/space_assets/planet_9.png"
 ];
+
+// Credits: https://lottiefiles.com/free-animation/s-satellite-vfnNE8AALo
 const satelliteImages = [
     "../Seasonals/Resources/space_assets/Satellite_1.gif",
     "../Seasonals/Resources/space_assets/Satellite_2.gif"
 ];
 
+// Credit: https://pixabay.com/de/illustrations/raumstation-raum-struktur-8023777/
 const issImage = "../Seasonals/Resources/space_assets/iss.png";
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/rocket-MYUQ3UFq3k
+ * https://pixabay.com/de/vectors/space-shuttle-atlantis-nasa-156012/
+ */
 const rocketImages = [
     "../Seasonals/Resources/space_assets/rocket.gif",
     "../Seasonals/Resources/space_assets/space-shuttle.png"
@@ -78,26 +88,19 @@ function createSpace() {
         document.body.appendChild(container);
     }
 
-    const standardPlanetCount = 4;
+    // const standardPlanetCount = 4;
-    const standardAstronautCount = 1;
+    // const standardAstronautCount = 1;
-    const standardSatelliteCount = 2;
+    // const standardSatelliteCount = 2;
-    const standardIssCount = 1;
+    // const standardIssCount = 1;
-    const standardRocketCount = 1;
+    // const standardRocketCount = 1;
 
     let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
-    let pCount = planetCountConf;
+    let divisor = isMobile ? Math.max(1, symbolCountMobile) : 1;
-    let aCount = astronautCountConf;
+    let pCount = Math.floor(planetCountConf / divisor);
-    let sCount = satelliteCountConf;
+    let aCount = Math.floor(astronautCountConf / divisor);
-    let iCount = issCountConf;
+    let sCount = Math.floor(satelliteCountConf / divisor);
-    let rCount = rocketCountConf;
+    let iCount = Math.floor(issCountConf / divisor);
-
+    let rCount = Math.floor(rocketCountConf / divisor);
-    if (isMobile && !enableRandomMobile) {
-        pCount = standardPlanetCount;
-        aCount = standardAstronautCount;
-        sCount = standardSatelliteCount;
-        iCount = standardIssCount;
-        rCount = standardRocketCount;
-    }
 
     // Add Nebula Glow
     const bgGlow = document.createElement('div');

Jellyfin.Plugin.Seasonals/Web/spooky.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Spooky || {};
 
-const spooky = config.EnableSpooky !== undefined ? config.EnableSpooky : true; // enable/disable
+const spooky = config.EnableSpooky !== undefined ? config.EnableSpooky : true; // enable/disable spooky
-const spookyCount = config.SymbolCount || 25; // count of random extra symbols
+const spookyCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbols
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableSpookySway = config.EnableSpookySway !== undefined ? config.EnableSpookySway : true;
+const enableSpookySway = config.EnableSpookySway !== undefined ? config.EnableSpookySway : true; // enable/disable spooky sway
-const spookySize = config.SpookySize || 20;
+const spookySize = config.SpookySize !== undefined ? config.SpookySize : 20; // size of elements
-const spookyGlowSize = config.SpookyGlowSize !== undefined ? config.SpookyGlowSize : 2;
+const spookyGlowSize = config.SpookyGlowSize !== undefined ? config.SpookyGlowSize : 2; // size of element glow
 
 const spookyImages = [
   "../Seasonals/Resources/halloween_images/ghost_20x20.png",

Jellyfin.Plugin.Seasonals/Web/sports.js

@@ -1,29 +1,30 @@
 const config = window.SeasonalsPluginConfig?.Sports || {};
 
-const sports = config.EnableSports !== undefined ? config.EnableSports : true;
+const sports = config.EnableSports !== undefined ? config.EnableSports : true; // enable/disable sports
-const symbolCount = config.SymbolCount || 5;
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 5; // count of balls per category
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
+const enableTrophy = config.EnableTrophy !== undefined ? config.EnableTrophy : false; // enable/disable trophy
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const rawSportsBalls = config.SportsBalls !== undefined ? config.SportsBalls : 'football,basketball,tennis,volleyball'; // set sports categories to spawn
-const enableTrophy = config.EnableTrophy !== undefined ? config.EnableTrophy : false;
+const turfColorHex = config.TurfColor !== undefined ? config.TurfColor : '#228b22'; // color of turf
+const confettiColors = config.ConfettiColors ? config.ConfettiColors.split(',') : ['#000000', '#FF0000', '#FFCC00']; // Add Country Colored confetti
 
 // Pre-declare and manage image assets
+// Credits: https://flaticon.com
 const SPORTS_ASSETS = {
-  badminton: ['badminton_1', 'badminton_2'],
+    badminton: ['badminton_1', 'badminton_2'],
-  baseball: ['baseball_1', 'baseball_2'],
+    baseball: ['baseball_1', 'baseball_2'],
-  basketball: ['basketball_1', 'basketball_2'],
+    basketball: ['basketball_1', 'basketball_2'],
-  billiard: Array.from({length: 14}, (_, i) => `billiard_ball_${i + 1}`),
+    billiard: Array.from({length: 14}, (_, i) => `billiard_ball_${i + 1}`),
-  bowling: ['bowling_1', 'bowling_2'],
+    bowling: ['bowling_1', 'bowling_2'],
-  football: Array.from({length: 5}, (_, i) => `football_${i + 1}`),
+    football: Array.from({length: 5}, (_, i) => `football_${i + 1}`),
-  golf: ['golf_ball_1', 'golf_ball_2'],
+    golf: ['golf_ball_1', 'golf_ball_2'],
-  rugby: ['rugby_ball_1', 'rugby_ball_2'],
+    rugby: ['rugby_ball_1', 'rugby_ball_2'],
-  table_tennis: ['table_tennis_ball_1', 'table_tennis_ball_2'],
+    table_tennis: ['table_tennis_ball_1', 'table_tennis_ball_2'],
-  tennis: ['tennis_ball_1', 'tennis_ball_2'],
+    tennis: ['tennis_ball_1', 'tennis_ball_2'],
-  volleyball: ['volleyball_1', 'volleyball_2'],
+    volleyball: ['volleyball_1', 'volleyball_2'],
-  waterball: ['waterball_1', 'waterball_2']
+    waterball: ['waterball_1', 'waterball_2']
 };
 
-const turfColorHex = config.TurfColor || '#228b22';
 
 let msgPrinted = false;
 
@@ -67,11 +68,10 @@ function createSports() {
         document.body.appendChild(container);
     }
 
-    // Parse turf color config
     // Create a turf/grass overlay at the bottom using the provided hex
     const turf = document.createElement('div');
     turf.className = 'sports-turf';
-    // Using hex with transparency (e.g., 4D = 30%, CC = 80%)
+    // Using hex with transparency
     turf.style.background = `linear-gradient(180deg, transparent 0%, ${turfColorHex}4D 30%, ${turfColorHex}CC 100%)`;
     container.appendChild(turf);
 
@@ -85,7 +85,6 @@ function createSports() {
     const useRandomDuration = enableDifferentDuration !== false;
 
     // Map standard sports balls to spawn based on category configuration
-    const rawSportsBalls = config.SportsBalls || 'football,basketball,tennis,volleyball';
     const chosenCategories = rawSportsBalls.split(',').map(s => s.trim()).filter(s => s !== '');
 
     const createBall = (randomItem) => {
@@ -140,7 +139,7 @@ function createSports() {
     // Create falling sports balls
     chosenCategories.forEach(category => {
         let variants = SPORTS_ASSETS[category];
-        if (!variants) variants = [category]; // Legacy fallback
+        if (!variants) variants = [category];
         
         for (let i = 0; i < ballsPerCategory; i++) {
             // Pick a random variant
@@ -162,7 +161,6 @@ function createSports() {
         
         let trophyImg = document.createElement('img');
         trophyImg.src = `../Seasonals/Resources/sport_assets/trophy.gif`;
-        // Randomly scale trophy slightly larger
         trophyImg.style.transform = `scale(${Math.random() * 0.5 + 0.8})`;
         trophyImg.onerror = function() {
             this.style.display = 'none';
@@ -211,8 +209,6 @@ function createSports() {
         setTimeout(() => { if (document.body.contains(container)) launchTrophy(); }, Math.random() * 5000 + 2000);
     }
 
-    // Add Germany Colored confetti (Black, Red, Gold)
-    const confettiColors = ['#000000', '#FF0000', '#FFCC00'];
     const confettiCount = isMobile ? 30 : 60;
     
     for (let i = 0; i < confettiCount; i++) {
@@ -257,8 +253,6 @@ function createSports() {
     }
 }
 
-/* Removed legacy fallback logic */
-
 function initializeSports() {
   if (!sports) return;
   createSports();

Jellyfin.Plugin.Seasonals/Web/spring.js

@@ -1,14 +1,14 @@
 const config = window.SeasonalsPluginConfig?.Spring || {};
 
-const spring = config.EnableSpring !== undefined ? config.EnableSpring : true; // Enable/disable spring
+const spring = config.EnableSpring !== undefined ? config.EnableSpring : true; // enable/disable spring
-const pollenCount = config.PollenCount || 30; // Number of pollen particles
+const pollenCount = config.PollenCount !== undefined ? config.PollenCount : 30; // count of pollen
-const sunbeamCount = config.SunbeamCount || 5; // Number of sunbeams
+const enableSunbeams = config.EnableSpringSunbeams !== undefined ? config.EnableSpringSunbeams : true; // enable/disable sunbeams
-const enableSunbeams = config.EnableSpringSunbeams !== undefined ? config.EnableSpringSunbeams : true; // Enable/disable sunbeams
+const sunbeamCount = config.SunbeamCount !== undefined ? config.SunbeamCount : 5; // count of sunbeams
-const birdCount = config.BirdCount !== undefined ? config.BirdCount : 3; // Number of birds
+const birdCount = config.BirdCount !== undefined ? config.BirdCount : 3; // count of birds
-const butterflyCount = config.ButterflyCount !== undefined ? config.ButterflyCount : 4; // Number of butterflies
+const butterflyCount = config.ButterflyCount !== undefined ? config.ButterflyCount : 4; // count of butterflies
-const beeCount = config.BeeCount !== undefined ? config.BeeCount : 2; // Number of bees
+const beeCount = config.BeeCount !== undefined ? config.BeeCount : 2; // count of bees
-const ladybugCount = config.LadybugCount !== undefined ? config.LadybugCount : 2; // Number of ladybugs
+const ladybugCount = config.LadybugCount !== undefined ? config.LadybugCount : 2; // count of ladybugs
-const randomSpring = config.EnableRandomSpring !== undefined ? config.EnableRandomSpring : true; // Enable random spring objects
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
 
 // Credit: https://lottiefiles.com/free-animation/birds-flying-V7O0L8jkOg
 const birdImages = [
@@ -23,7 +23,10 @@ const butterflyImages = [
     '../Seasonals/Resources/spring_assets/Butterfly_2.gif'
 ];
 
+// Credit: https://lottiefiles.com/free-animation/loading-flying-beee-WcTfIccdJZ
 const beeImage = '../Seasonals/Resources/spring_assets/Bee.gif';
+
+// Credit: https://pixabay.com/gifs/ladybug-insect-nature-fly-wings-5068/
 const ladybugImage = '../Seasonals/Resources/spring_assets/ladybug.gif';
 
 let msgPrinted = false;
@@ -230,28 +233,35 @@ function initializeSpring() {
 
     const container = document.querySelector('.spring-container');
     if (container) {
-        if (randomSpring) {
+        let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
-            // Add Pollen
+        let divisor = isMobile ? Math.max(1, symbolCountMobile) : 1;
-            for (let i = 0; i < pollenCount; i++) {
-                createPollen(container);
-            }
 
-            // Add Birds
+        let adjPollen = Math.floor(pollenCount / divisor);
-            for (let i = 0; i < birdCount; i++) {
+        let adjBird = Math.floor(birdCount / divisor);
-                setTimeout(() => createBird(container), Math.random() * 1000); // 0-1s desync
+        let adjButterfly = Math.floor(butterflyCount / divisor);
-            }
+        let adjBee = Math.floor(beeCount / divisor);
-            // Add Butterflies
+        let adjLadybug = Math.floor(ladybugCount / divisor);
-            for (let i = 0; i < butterflyCount; i++) {
+
-                setTimeout(() => createButterfly(container), Math.random() * 1000); // 0-1s desync
+        // Add Pollen
-            }
+        for (let i = 0; i < adjPollen; i++) {
-            // Add Bees
+            createPollen(container);
-            for (let i = 0; i < beeCount; i++) {
+        }
-                setTimeout(() => createBee(container), Math.random() * 1000); // 0-1s desync
+
-            }
+        // Add Birds
-            // Add Ladybugs
+        for (let i = 0; i < adjBird; i++) {
-            for (let i = 0; i < ladybugCount; i++) {
+            setTimeout(() => createBird(container), Math.random() * 1000); // 0-1s desync
-                setTimeout(() => createLadybugGif(container), Math.random() * 1000); // 0-1s desync
+        }
-            }
+        // Add Butterflies
+        for (let i = 0; i < adjButterfly; i++) {
+            setTimeout(() => createButterfly(container), Math.random() * 1000); // 0-1s desync
+        }
+        // Add Bees
+        for (let i = 0; i < adjBee; i++) {
+            setTimeout(() => createBee(container), Math.random() * 1000); // 0-1s desync
+        }
+        // Add Ladybugs
+        for (let i = 0; i < adjLadybug; i++) {
+            setTimeout(() => createLadybugGif(container), Math.random() * 1000); // 0-1s desync
         }
     }
 }

Jellyfin.Plugin.Seasonals/Web/starwars.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.StarWars || {};
-const starwars = config.EnableStarWars !== undefined ? config.EnableStarWars : true;
+const starwars = config.EnableStarWars !== undefined ? config.EnableStarWars : true; // enable/disable starwars
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/storm.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Storm || {};
 
-const enabled = config.EnableStorm !== undefined ? config.EnableStorm : true;
+const enabled = config.EnableStorm !== undefined ? config.EnableStorm : true; // enable/disable storm
 const isMobile = window.innerWidth <= 768;
-const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300);
+const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300); // count of raindrops
-const enableLightning = config.EnableLightning !== undefined ? config.EnableLightning : true;
+const enableLightning = config.EnableLightning !== undefined ? config.EnableLightning : true; // enable/disable lightning
-const rainSpeed = config.RainSpeed || 1.0;
+const rainSpeed = config.RainSpeed !== undefined ? config.RainSpeed : 1.0; // speed of rain
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/summer.js

@@ -1,11 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Summer || {};
 
-const summer = config.EnableSummer !== undefined ? config.EnableSummer : true; // Enable/disable summer theme
+const summer = config.EnableSummer !== undefined ? config.EnableSummer : true; // enable/disable summer
-const bubbleCount = config.BubbleCount || 30; // Number of bubbles
+const bubbleCount = config.BubbleCount !== undefined ? config.BubbleCount : 30; // count of bubbles
-const dustCount = config.DustCount || 50; // Number of dust particles
+const dustCount = config.DustCount !== undefined ? config.DustCount : 50; // count of dust particles
-const randomSummer = config.EnableRandomSummer !== undefined ? config.EnableRandomSummer : true; // Enable random generating objects
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
-const randomSummerMobile = config.EnableRandomSummerMobile !== undefined ? config.EnableRandomSummerMobile : false; // Enable random generating objects on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // Randomize animation duration of bubbles and dust
 
 let msgPrinted = false;
 
@@ -39,34 +38,23 @@ observer.observe(document.body, {
   subtree: true,
   attributes: true
 });
-function createBubble(container, isDust = false) {
+
+function createBubble(container) {
     const bubble = document.createElement('div');
-    
+
-    if (isDust) {
+    bubble.classList.add('summer-bubble');
-        bubble.classList.add('summer-dust');
-    } else {
-        bubble.classList.add('summer-bubble');
-    }
 
     // Random horizontal position
     const randomLeft = Math.random() * 100;
     bubble.style.left = `${randomLeft}%`;
 
-    // Random size
+    // MARK: BUBBLE SIZE
-    if (!isDust) {
+    const size = Math.random() * 20 + 10; // 10-30px bubbles
-        // MARK: BUBBLE SIZE
+    bubble.style.width = `${size}px`;
-        const size = Math.random() * 20 + 10; // 10-30px bubbles
+    bubble.style.height = `${size}px`;
-        bubble.style.width = `${size}px`;
-        bubble.style.height = `${size}px`;
-    } else {
-        // MARK: DUST SIZE
-        const size = Math.random() * 3 + 1; // 1-4px dust
-        bubble.style.width = `${size}px`;
-        bubble.style.height = `${size}px`;
-    }
 
     // Animation properties
-    const duration = isDust ? (Math.random() * 20 + 10) : (Math.random() * 10 + 5); // Dust is slower
+    const duration = (Math.random() * 10 + 5);
     const delay = Math.random() * 10;
     
     if (enableDifferentDuration) {
@@ -77,19 +65,30 @@ function createBubble(container, isDust = false) {
     container.appendChild(bubble);
 }
 
-function addRandomSummerObjects() {
+function createDust(container) {
-    const container = document.querySelector('.summer-container');
+    const dust = document.createElement('div');
-    if (!container) return;
+
+    dust.classList.add('summer-dust');
+
+    // Random horizontal position
+    const randomLeft = Math.random() * 100;
+    dust.style.left = `${randomLeft}%`;
+
+    // MARK: DUST SIZE
+    const size = Math.random() * 3 + 1; // 1-4px dust
+    dust.style.width = `${size}px`;
+    dust.style.height = `${size}px`;
+
+    // Animation properties
+    const duration = (Math.random() * 20 + 10); // Dust is slower
+    const delay = Math.random() * 10;
     
-    // Add bubbles
+    if (enableDifferentDuration) {
-    for (let i = 0; i < bubbleCount; i++) {
+        dust.style.animationDuration = `${duration}s`;
-        createBubble(container, false);
-    }
-    
-    // Add some dust particles
-    for (let i = 0; i < dustCount; i++) {
-        createBubble(container, true);
     }
+    dust.style.animationDelay = `${delay}s`;
+
+    container.appendChild(dust);
 }
 
 function initSummerObjects() {
@@ -101,38 +100,18 @@ function initSummerObjects() {
         document.body.appendChild(container);
     }
     
-    // Initial bubbles/dust
+    let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
-    for (let i = 0; i < 10; i++) {
+    let limitBubbles = isMobile ? Math.floor(bubbleCount / Math.max(1, symbolCountMobile)) : bubbleCount;
-        const bubble = document.createElement('div');
+    let limitDust = isMobile ? Math.floor(dustCount / Math.max(1, symbolCountMobile)) : dustCount;
-        const isDust = Math.random() > 0.5;
+
-        if (isDust) {
+    // Initial bubbles
-            bubble.classList.add('summer-dust');
+    for (let i = 0; i < limitBubbles; i++) {
-        } else {
+        createBubble(container);
-            bubble.classList.add('summer-bubble');
+    }
-        }
+    
-        
+    // Initial dust
-        const randomLeft = Math.random() * 100;
+    for (let i = 0; i < limitDust; i++) {
-        bubble.style.left = `${randomLeft}%`;
+        createDust(container);
-        
-        if (!isDust) {
-            // MARK: BUBBLE SIZE
-            const size = Math.random() * 20 + 10;
-            bubble.style.width = `${size}px`;
-            bubble.style.height = `${size}px`;
-        } else {
-            // MARK: DUST SIZE
-            const size = Math.random() * 3 + 1;
-            bubble.style.width = `${size}px`;
-            bubble.style.height = `${size}px`;
-        }
-        
-        const duration = isDust ? (Math.random() * 20 + 10) : (Math.random() * 10 + 5);
-        if (enableDifferentDuration) {
-           bubble.style.animationDuration = `${duration}s`;
-        }
-        
-        bubble.style.animationDelay = `-${Math.random() * 10}s`;
-        container.appendChild(bubble);
     }
 }
 
@@ -140,11 +119,6 @@ function initializeSummer() {
     if (!summer) return;
     initSummerObjects();
     toggleSummer();
-
-    const screenWidth = window.innerWidth;
-    if (randomSummer && (screenWidth > 768 || randomSummerMobile)) {
-        addRandomSummerObjects();
-    }
 }
 
 initializeSummer();

Jellyfin.Plugin.Seasonals/Web/underwater.js

@@ -1,43 +1,63 @@
 const config = window.SeasonalsPluginConfig?.Underwater || {};
 
-const underwater = config.EnableUnderwater !== undefined ? config.EnableUnderwater : true;
+const underwater = config.EnableUnderwater !== undefined ? config.EnableUnderwater : true; // enable/disable underwater
-const symbolCount = config.SymbolCount || 15;
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
+const enableLightRays = config.EnableLightRays !== undefined ? config.EnableLightRays : true; // enable/disable lightrays
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const seaweedCount = config.SeaweedCount !== undefined ? config.SeaweedCount : 50; // count of seaweed
-const enableLightRays = config.EnableLightRays !== undefined ? config.EnableLightRays : true;
-const seaweedCount = config.SeaweedCount !== undefined ? config.SeaweedCount : 50;
 
 // Entity counts configured
-const fishCount = config.FishCount !== undefined ? config.FishCount : 15;
+const fishCount = config.FishCount !== undefined ? config.FishCount : 15; // count of fish
-const seahorseCount = config.SeahorseCount !== undefined ? config.SeahorseCount : 3;
+const seahorseCount = config.SeahorseCount !== undefined ? config.SeahorseCount : 3; // count of seahorse
-const jellyfishCount = config.JellyfishCount !== undefined ? config.JellyfishCount : 3;
+const jellyfishCount = config.JellyfishCount !== undefined ? config.JellyfishCount : 3; // count of jellyfish
-const turtleCount = config.TurtleCount !== undefined ? config.TurtleCount : 1;
+const turtleCount = config.TurtleCount !== undefined ? config.TurtleCount : 1; // count of turtle
-const crabCount = config.CrabCount !== undefined ? config.CrabCount : 2;
+const crabCount = config.CrabCount !== undefined ? config.CrabCount : 2; // count of crab
-const starfishCount = config.StarfishCount !== undefined ? config.StarfishCount : 2;
+const starfishCount = config.StarfishCount !== undefined ? config.StarfishCount : 2; // count of starfish
-const shellCount = config.ShellCount !== undefined ? config.ShellCount : 2;
+const shellCount = config.ShellCount !== undefined ? config.ShellCount : 2; // count of shell
 
+// credits: https://lottiefiles.com/free-animation/seaweed-E6Go0HdkqY
 const seaweeds = [
     "../Seasonals/Resources/underwater_assets/seaweed_1.gif",
     "../Seasonals/Resources/underwater_assets/seaweed_2.gif"
 ];
 
-// Statics for bottom
+/**
+ * Credits:
+ * https://www.animierte-gifs.net/img-animiertes-krebs-bild-0041-59970.htm
+ * https://www.animierte-gifs.net/img-animiertes-krebs-bild-0002-59931.htm
+ * 
+ */
 const crabImages = [
     "../Seasonals/Resources/underwater_assets/crab_1.gif",
     "../Seasonals/Resources/underwater_assets/crab_2.gif",
     "../Seasonals/Resources/underwater_assets/crab_3.gif"
 ];
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/dancing-starfish-tJ9ZFu9Zq0
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0003-50003.htm
+ */
 const starfishImages = [
     "../Seasonals/Resources/underwater_assets/starfish_1.gif",
     "../Seasonals/Resources/underwater_assets/starfish_2.gif"
 ];
 
+// Credit: https://www.animierte-gifs.net/img-animiertes-muschel-bild-0021-108539.htm
 const shellImages = [
     "../Seasonals/Resources/underwater_assets/shell_1.gif"
 ];
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/0101uwt-tt-01-4fA4Lm9gtN
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0473-50473.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0290-50290.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0049-50049.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0403-50403.htm
+ * 
+ * https://flaticon.com
+ */
 const fishImages = [
     "../Seasonals/Resources/underwater_assets/fish_1.gif",
     "../Seasonals/Resources/underwater_assets/fish_2.gif",
@@ -55,15 +75,22 @@ const fishImages = [
     "../Seasonals/Resources/underwater_assets/fish_15.png"
 ];
 
+/**
+ * Credits:
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0221-50221.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0217-50217.htm
+ */
 const seahorsesImages = [
     "../Seasonals/Resources/underwater_assets/seahorse_1.gif",
     "../Seasonals/Resources/underwater_assets/seahorse_2.gif"
 ];
 
+// credit: https://lottiefiles.com/free-animation/sea-turtle-s0sbHIWS2F
 const turtleImages = [
     "../Seasonals/Resources/underwater_assets/turtle.gif"
 ];
 
+// credits: https://lottiefiles.com/free-animation/jellyfish-wPwyF8EeSQ
 const jellyfishImages = [
     "../Seasonals/Resources/underwater_assets/jellyfish_1.gif",
     "../Seasonals/Resources/underwater_assets/jellyfish_2.gif"
@@ -137,16 +164,15 @@ function createUnderwater() {
     const useRandomDuration = enableDifferentDuration !== false;
     let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
 
-
     // Seaweed swaying at the bottom (evenly distributed based on count)
-    const activeSeaweedCount = Math.max(1, seaweedCount);
+    const activeSeaweedCount = isMobile ? Math.max(1, Math.floor(seaweedCount / Math.max(1, symbolCountMobile))) : Math.max(1, seaweedCount);
     const seaweedSpacing = 95 / activeSeaweedCount;
-    for (let i = 0; i < seaweedCount; i++) {
+    for (let i = 0; i < activeSeaweedCount; i++) {
         let seaweed = document.createElement('div');
         seaweed.className = 'underwater-seaweed';
         seaweed.style.position = 'absolute';
         
-        // MARK: Distance from the bottom edge for the seaweed
+        // Distance from the bottom edge for the seaweed
         seaweed.style.bottom = '-18px';
         
         let offset = (Math.random() * seaweedSpacing) - (seaweedSpacing / 2);
@@ -163,7 +189,7 @@ function createUnderwater() {
         seaweed.style.transform = `scale(${scale}) ${flip}`;
         seaweed.style.zIndex = depth < 0.5 ? '15' : '30';
 
-        // Mix Emojis and GIFs
+        // Mix Emojis and GIFs for seaweed
         if (Math.random() > 0.4) {
             let img = document.createElement('img');
             img.src = seaweeds[Math.floor(Math.random() * seaweeds.length)];
@@ -182,9 +208,8 @@ function createUnderwater() {
 
     // Static Bottom Creatures logic
     function spawnStatic(imageArray, maxCount, baseSize) {
-        // Evaluate an actual count between 1 and maxCount if random symbols are enabled
+        let spawnLimit = isMobile ? Math.floor(maxCount / Math.max(1, symbolCountMobile)) : maxCount;
-        const actualCount = (useRandomSymbols && maxCount > 0) ? Math.floor(Math.random() * maxCount) + 1 : maxCount;
+        for (let i = 0; i < spawnLimit; i++) {
-        for (let i = 0; i < actualCount; i++) {
             let creature = document.createElement('div');
             creature.className = 'underwater-static-bottom';
             creature.style.position = 'absolute';
@@ -216,13 +241,9 @@ function createUnderwater() {
     // Swimmers logic
     function spawnSwimmerLoop(imageArray, maxCount, baseSize, typeName) {
         if (maxCount <= 0) return;
-        let spawnLimit = isMobile ? (enableRandomMobile ? maxCount : Math.floor(maxCount / 2)) : maxCount;
+        let spawnLimit = isMobile ? Math.floor(maxCount / Math.max(1, symbolCountMobile)) : maxCount;
         
-        // Randomize the actual amount spawned up to the limit
+        for (let i = 0; i < spawnLimit; i++) {
-        const actualCount = (useRandomSymbols && spawnLimit > 0) ? Math.floor(Math.random() * spawnLimit) + 1 : spawnLimit;
-        
-        for (let i = 0; i < actualCount; i++) {
-            // Spawn immediately but use negative delay to distribute them across the screen!
             spawnSingleSwimmer(imageArray, baseSize, typeName);
         }
     }