Update manifest.json for release v1.6.13.5 [skip ci]

Reviewed-on: #1

.gitea/workflows/build.yml

@@ -0,0 +1,45 @@
+name: '🏗️ Build Plugin'
+
+on:
+  push:
+    branches:
+      - dev
+    paths-ignore:
+      - '**/*.md'
+      - '.gitea/**'
+      - '.github/**'
+      - 'jellyfin.ruleset'
+      - '.gitignore'
+      - '.editorconfig'
+      - 'LICENSE'
+      - 'logo.png'
+  pull_request:
+    paths-ignore:
+      - '**/*.md'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "9.x"
+
+      - name: Build Jellyfin Plugin
+        run: |
+          dotnet build Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj --configuration Release --output bin/Publish
+          cd bin/Publish
+          zip -r Jellyfin.Plugin.Seasonals.zip *
+          
+      - name: Upload Artifact
+        uses: christopherHX/gitea-upload-artifact@v4
+        with:
+          name: plugin-build-artifact
+          retention-days: 5
+          if-no-files-found: error
+          path: bin/Publish/Jellyfin.Plugin.Seasonals.zip

.gitea/workflows/build_old.yaml.deprecated

@@ -0,0 +1,45 @@
+name: '🏗️ Build Plugin'
+
+on:
+  push:
+    paths-ignore:
+      - '**/*.md'
+      - '.gitea/**'
+      - '.github/**'
+      - 'jellyfin.ruleset'
+      - '.gitignore'
+      - '.editorconfig'
+      - 'LICENSE'
+      - 'logo.png'
+  pull_request:
+    paths-ignore:
+      - '**/*.md'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    env:
+      PIP_BREAK_SYSTEM_PACKAGES: "1"
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "9.x"
+
+      - name: Build Jellyfin Plugin
+        uses: oddstr13/jellyfin-plugin-repository-manager@v1.1.1
+        id: jprm
+        with:
+          dotnet-target: "net9.0"
+
+      - name: Upload Artifact
+        uses: christopherHX/gitea-upload-artifact@v4
+        with:
+          name: plugin-build-artifact
+          retention-days: 5
+          if-no-files-found: error
+          path: ${{ steps.jprm.outputs.artifact }}

.gitea/workflows/release_automation.yml

@@ -0,0 +1,186 @@
+name: Auto Release Plugin
+
+on:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - '.gitea/**'
+      - '.github/**'
+      - '*.md'
+      - 'jellyfin.ruleset'
+      - '.gitignore'
+      - '.editorconfig'
+      - 'LICENSE'
+      - 'logo.png'
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: '9.x'
+
+      - name: Read Version from Manifest
+        id: read_version
+        run: |
+          VERSION=$(jq -r '.[0].versions[0].version' manifest.json)
+          CHANGELOG=$(jq -r '.[0].versions[0].changelog' manifest.json)
+          TARGET_ABI=$(jq -r '.[0].versions[0].targetAbi' manifest.json)
+          
+          echo "Detected Version: $VERSION"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+          echo "TARGET_ABI=$TARGET_ABI" >> $GITHUB_ENV
+          
+          # Also export GUID for later use
+          PLUGIN_GUID=$(jq -r '.[0].guid' manifest.json)
+          echo "PLUGIN_GUID=$PLUGIN_GUID" >> $GITHUB_ENV
+          
+          # Escape newlines in changelog for GITHUB_ENV
+          echo "CHANGELOG<<EOF" >> $GITHUB_ENV
+          echo "$CHANGELOG" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Build and Zip
+        shell: bash
+        run: |
+          # Inject version from manifest into the build
+          dotnet build Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj --configuration Release --output bin/Publish /p:Version=${{ env.VERSION }} /p:AssemblyVersion=${{ env.VERSION }}
+          
+          cd bin/Publish
+          zip -r Jellyfin.Plugin.Seasonals.zip *
+          cd ../..
+          
+          # Calculate hash
+          HASH=$(md5sum bin/Publish/Jellyfin.Plugin.Seasonals.zip | awk '{ print $1 }')
+          TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+          
+          # Export variables for next steps
+          echo "ZIP_HASH=$HASH" >> $GITHUB_ENV
+          echo "BUILD_TIME=$TIME" >> $GITHUB_ENV
+          echo "ZIP_PATH=bin/Publish/Jellyfin.Plugin.Seasonals.zip" >> $GITHUB_ENV
+
+      - name: Update manifest.json
+        shell: bash
+        run: |
+            REPO_OWNER="${{ github.repository_owner }}"
+            REPO_NAME="${{ github.event.repository.name }}"
+            VERSION="${{ env.VERSION }}"
+            DOWNLOAD_URL="https://git.mahom03-spacecloud.de/$REPO_OWNER/$REPO_NAME/releases/download/v$VERSION/Jellyfin.Plugin.Seasonals.zip"
+            
+            echo "Updating manifest.json with:"
+            echo "Hash: ${{ env.ZIP_HASH }}"
+            echo "Time: ${{ env.BUILD_TIME }}"
+            echo "Url:  $DOWNLOAD_URL"
+            
+            jq --arg hash "${{ env.ZIP_HASH }}" \
+             --arg time "${{ env.BUILD_TIME }}" \
+             --arg url "$DOWNLOAD_URL" \
+             '.[0].versions[0].checksum = $hash | .[0].versions[0].timestamp = $time | .[0].versions[0].sourceUrl = $url' \
+             manifest.json > manifest.json.tmp && mv manifest.json.tmp manifest.json
+
+      - name: Commit manifest.json
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          commit_message: "Update manifest.json for release v${{ env.VERSION }} [skip ci]"
+          file_pattern: manifest.json
+
+      - name: Create Release
+        uses: akkuman/gitea-release-action@v1
+        with:
+          server_url: "https://git.mahom03-spacecloud.de"
+          body: ${{ env.CHANGELOG }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+          files: ${{ env.ZIP_PATH }}
+          name: "v${{ env.VERSION }}"
+          tag_name: "v${{ env.VERSION }}"
+          draft: false
+          prerelease: false
+
+      # Update Message in Remote Repository
+      - name: Checkout Central Manifest Repo
+        uses: actions/checkout@v6
+        with:
+          repository: ${{ github.repository_owner }}/jellyfin-plugin-manifest
+          path: central-manifest
+          token: ${{ secrets.JELLYFIN_PLUGIN_MANIFEST_UPDATER_PAT }}
+
+      - name: Update Central Manifest
+        shell: bash
+        run: |
+            cd central-manifest
+            
+            REPO_OWNER="${{ github.repository_owner }}"
+            REPO_NAME="${{ github.event.repository.name }}"
+            
+            # 1. Get info from previous steps
+            VERSION="${{ env.VERSION }}"
+            HASH="${{ env.ZIP_HASH }}"
+            TIME="${{ env.BUILD_TIME }}"
+            DOWNLOAD_URL="https://git.mahom03-spacecloud.de/$REPO_OWNER/$REPO_NAME/releases/download/v$VERSION/Jellyfin.Plugin.Seasonals.zip"
+            
+            # 2. Get info from env
+            PLUGIN_GUID="${{ env.PLUGIN_GUID }}"
+            CHANGELOG="${{ env.CHANGELOG }}"
+            TARGET_ABI="${{ env.TARGET_ABI }}"
+            
+            echo "Updating Central Manifest for Plugin GUID: $PLUGIN_GUID"
+            
+            # 3. Update/Prepend entry in central manifest.json
+            # Logic:
+            # - If array is empty or new version != old version: PREPEND new entry
+            # - If new version == old version: OVERWRITE (update) existing entry (re-release)
+            
+            jq --arg guid "$PLUGIN_GUID" \
+               --arg hash "$HASH" \
+               --arg time "$TIME" \
+               --arg url "$DOWNLOAD_URL" \
+               --arg ver "$VERSION" \
+               --arg changelog "$CHANGELOG" \
+               --arg abi "$TARGET_ABI" \
+               'map(if .guid == $guid then 
+                  if .versions[0].version != $ver then
+                      # New Version -> Prepend
+                      .versions = [{
+                        "version": $ver,
+                        "changelog": $changelog,
+                        "targetAbi": $abi,
+                        "sourceUrl": $url,
+                        "checksum": $hash,
+                        "timestamp": $time
+                      }] + .versions
+                  else
+                      # Same Version -> Update existing (overwrite top)
+                      .versions[0].changelog = $changelog |
+                      .versions[0].targetAbi = $abi |
+                      .versions[0].sourceUrl = $url |
+                      .versions[0].checksum = $hash |
+                      .versions[0].timestamp = $time
+                  end
+                else . end)' \
+               manifest.json > manifest.json.tmp && mv manifest.json.tmp manifest.json
+               
+      - name: Commit and Push Central Manifest
+        run: |
+          cd central-manifest
+          git config user.name "CodeDevMLH"
+          git config user.email "145071728+CodeDevMLH@users.noreply.github.com"
+          
+          # Check if there are changes
+          if [[ -n $(git status -s) ]]; then
+            git add manifest.json
+            git commit -m "Auto-Update Seasonals to v${{ env.VERSION }}"
+            git push
+          else
+            echo "No changes to central manifest."
+          fi

.github/workflows/build.yaml

@@ -3,16 +3,43 @@ name: '🏗️ Build Plugin'
 on:
   push:
     branches:
-      - master
+      - dev
     paths-ignore:
       - '**/*.md'
+      - '.gitea/**'
+      - '.github/**'
+      - 'jellyfin.ruleset'
+      - '.gitignore'
+      - '.editorconfig'
+      - 'LICENSE'
+      - 'logo.png'
   pull_request:
-    branches:
-      - master
     paths-ignore:
       - '**/*.md'
   workflow_dispatch:
 
 jobs:
-  call:
+  build:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/build.yaml@master
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v6
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "9.x"
+
+      - name: Build Jellyfin Plugin
+        run: |
+          dotnet build Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj --configuration Release --output bin/Publish
+          cd bin/Publish
+          zip -r Jellyfin.Plugin.Seasonals.zip *
+
+      - name: Upload Artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: plugin-build-artifact
+          retention-days: 5
+          if-no-files-found: error
+          path: bin/Publish/Jellyfin.Plugin.Seasonals.zip

.github/workflows/changelog.yaml

@@ -1,20 +0,0 @@
-name: '📝 Create/Update Release Draft & Release Bump PR'
-
-on:
-  push:
-    branches:
-      - master
-    paths-ignore:
-      - build.yaml
-  workflow_dispatch:
-  repository_dispatch:
-    types:
-      - update-prep-command
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/changelog.yaml@master
-    with:
-      repository-name: jellyfin/jellyfin-plugin-template
-    secrets:
-      token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/command-dispatch.yaml

@@ -1,13 +0,0 @@
-# Allows for the definition of PR and Issue /commands
-name: '📟 Slash Command Dispatcher'
-
-on:
-  issue_comment:
-    types:
-      - created
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/command-dispatch.yaml@master
-    secrets:
-      token: .

.github/workflows/command-rebase.yaml

@@ -1,16 +0,0 @@
-name: '🔀 PR Rebase Command'
-
-on:
-  repository_dispatch:
-    types:
-      - rebase-command
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/command-rebase.yaml@master
-    with:
-      rebase-head: ${{ github.event.client_payload.pull_request.head.label }}
-      repository-full-name: ${{ github.event.client_payload.github.payload.repository.full_name }}
-      comment-id: ${{ github.event.client_payload.github.payload.comment.id }}
-    secrets:
-      token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/publish.yaml

@@ -1,18 +0,0 @@
-name: '🚀 Publish Plugin'
-
-on:
-  release:
-    types:
-      - released
-  workflow_dispatch:
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/publish.yaml@master
-    with:
-      version: ${{ github.event.release.tag_name }}
-      is-unstable: ${{ github.event.release.prerelease }}
-    secrets:
-      deploy-host: ${{ secrets.DEPLOY_HOST }}
-      deploy-user: ${{ secrets.DEPLOY_USER }}
-      deploy-key: ${{ secrets.DEPLOY_KEY }}

.github/workflows/release_automation.yml

@@ -0,0 +1,184 @@
+name: Auto Release Plugin
+
+on:
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - '.github/**'
+      - 'README.md'
+      - 'jellyfin.ruleset'
+      - '.gitignore'
+      - '.editorconfig'
+      - 'LICENSE'
+      - 'logo.png'
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: '9.x'
+
+      - name: Read Version from Manifest
+        id: read_version
+        run: |
+          VERSION=$(jq -r '.[0].versions[0].version' manifest.json)
+          CHANGELOG=$(jq -r '.[0].versions[0].changelog' manifest.json)
+          TARGET_ABI=$(jq -r '.[0].versions[0].targetAbi' manifest.json)
+          
+          echo "Detected Version: $VERSION"
+          echo "VERSION=$VERSION" >> $GITHUB_ENV
+          echo "TARGET_ABI=$TARGET_ABI" >> $GITHUB_ENV
+          
+          # Also export GUID for later use
+          PLUGIN_GUID=$(jq -r '.[0].guid' manifest.json)
+          echo "PLUGIN_GUID=$PLUGIN_GUID" >> $GITHUB_ENV
+          
+          # Escape newlines in changelog for GITHUB_ENV
+          echo "CHANGELOG<<EOF" >> $GITHUB_ENV
+          echo "$CHANGELOG" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+
+      - name: Build and Zip
+        shell: bash
+        run: |
+          # Inject version from manifest into the build
+          dotnet build Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj --configuration Release --output bin/Publish /p:Version=${{ env.VERSION }} /p:AssemblyVersion=${{ env.VERSION }}
+          
+          cd bin/Publish
+          zip -r Jellyfin.Plugin.Seasonals.zip *
+          cd ../..
+          
+          # Calculate hash
+          HASH=$(md5sum bin/Publish/Jellyfin.Plugin.Seasonals.zip | awk '{ print $1 }')
+          TIME=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+          
+          # Export variables for next steps
+          echo "ZIP_HASH=$HASH" >> $GITHUB_ENV
+          echo "BUILD_TIME=$TIME" >> $GITHUB_ENV
+          echo "ZIP_PATH=bin/Publish/Jellyfin.Plugin.Seasonals.zip" >> $GITHUB_ENV
+
+      - name: Update manifest.json
+        shell: bash
+        run: |
+            REPO_OWNER="${{ github.repository_owner }}"
+            REPO_NAME="${{ github.event.repository.name }}"
+            VERSION="${{ env.VERSION }}"
+            DOWNLOAD_URL="https://github.com/$REPO_OWNER/$REPO_NAME/releases/download/v$VERSION/Jellyfin.Plugin.Seasonals.zip"
+            
+            echo "Updating manifest.json with:"
+            echo "Hash: ${{ env.ZIP_HASH }}"
+            echo "Time: ${{ env.BUILD_TIME }}"
+            echo "Url:  $DOWNLOAD_URL"
+            
+            jq --arg hash "${{ env.ZIP_HASH }}" \
+             --arg time "${{ env.BUILD_TIME }}" \
+             --arg url "$DOWNLOAD_URL" \
+             '.[0].versions[0].checksum = $hash | .[0].versions[0].timestamp = $time | .[0].versions[0].sourceUrl = $url' \
+             manifest.json > manifest.json.tmp && mv manifest.json.tmp manifest.json
+
+      - name: Commit manifest.json
+        uses: stefanzweifel/git-auto-commit-action@v7
+        with:
+          commit_message: "Update manifest.json for release v${{ env.VERSION }} [skip ci]"
+          file_pattern: manifest.json
+
+      - name: Create Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: "v${{ env.VERSION }}"
+          name: "v${{ env.VERSION }}"
+          # body: ${{ env.CHANGELOG }}
+          files: ${{ env.ZIP_PATH }}
+          draft: false
+          prerelease: false
+          generate_release_notes: true
+
+      # Update Message in Remote Repository
+      - name: Checkout Central Manifest Repo
+        uses: actions/checkout@v6
+        with:
+          repository: ${{ github.repository_owner }}/jellyfin-plugin-manifest
+          path: central-manifest
+          token: ${{ secrets.JELLYFIN_PLUGIN_MANIFEST_UPDATER_PAT }}
+
+      - name: Update Central Manifest
+        shell: bash
+        run: |
+            cd central-manifest
+            
+            REPO_OWNER="${{ github.repository_owner }}"
+            REPO_NAME="${{ github.event.repository.name }}"
+            
+            # 1. Get info from previous steps
+            VERSION="${{ env.VERSION }}"
+            HASH="${{ env.ZIP_HASH }}"
+            TIME="${{ env.BUILD_TIME }}"
+            DOWNLOAD_URL="https://github.com/$REPO_OWNER/$REPO_NAME/releases/download/v$VERSION/Jellyfin.Plugin.Seasonals.zip"
+            
+            # 2. Get info from env
+            PLUGIN_GUID="${{ env.PLUGIN_GUID }}"
+            CHANGELOG="${{ env.CHANGELOG }}"
+            TARGET_ABI="${{ env.TARGET_ABI }}"
+            
+            echo "Updating Central Manifest for Plugin GUID: $PLUGIN_GUID"
+            
+            # 3. Update/Prepend entry in central manifest.json
+            # Logic:
+            # - If array is empty or new version != old version: PREPEND new entry
+            # - If new version == old version: OVERWRITE (update) existing entry (re-release)
+            
+            jq --arg guid "$PLUGIN_GUID" \
+               --arg hash "$HASH" \
+               --arg time "$TIME" \
+               --arg url "$DOWNLOAD_URL" \
+               --arg ver "$VERSION" \
+               --arg changelog "$CHANGELOG" \
+               --arg abi "$TARGET_ABI" \
+               'map(if .guid == $guid then 
+                  if .versions[0].version != $ver then
+                      # New Version -> Prepend
+                      .versions = [{
+                        "version": $ver,
+                        "changelog": $changelog,
+                        "targetAbi": $abi,
+                        "sourceUrl": $url,
+                        "checksum": $hash,
+                        "timestamp": $time
+                      }] + .versions
+                  else
+                      # Same Version -> Update existing (overwrite top)
+                      .versions[0].changelog = $changelog |
+                      .versions[0].targetAbi = $abi |
+                      .versions[0].sourceUrl = $url |
+                      .versions[0].checksum = $hash |
+                      .versions[0].timestamp = $time
+                  end
+                else . end)' \
+               manifest.json > manifest.json.tmp && mv manifest.json.tmp manifest.json
+               
+      - name: Commit and Push Central Manifest
+        run: |
+          cd central-manifest
+          git config user.name "CodeDevMLH"
+          git config user.email "145071728+CodeDevMLH@users.noreply.github.com"
+          
+          # Check if there are changes
+          if [[ -n $(git status -s) ]]; then
+            git add manifest.json
+            git commit -m "Auto-Update Seasonals to v${{ env.VERSION }}"
+            git push
+          else
+            echo "No changes to central manifest."
+          fi

.github/workflows/scan-codeql.yaml

@@ -1,20 +0,0 @@
-name: '🔬 Run CodeQL'
-
-on:
-  push:
-    branches: [ master ]
-    paths-ignore:
-      - '**/*.md'
-  pull_request:
-    branches: [ master ]
-    paths-ignore:
-      - '**/*.md'
-  schedule:
-    - cron: '24 2 * * 4'
-  workflow_dispatch:
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/scan-codeql.yaml@master
-    with:
-      repository-name: jellyfin/jellyfin-plugin-template

.github/workflows/test.yaml

@@ -1,18 +0,0 @@
-name: '🧪 Test Plugin'
-
-on:
-  push:
-    branches:
-      - master
-    paths-ignore:
-      - '**/*.md'
-  pull_request:
-    branches:
-      - master
-    paths-ignore:
-      - '**/*.md'
-  workflow_dispatch:
-
-jobs:
-  call:
-    uses: jellyfin/jellyfin-meta-plugins/.github/workflows/test.yaml@master

.gitignore

@@ -4,4 +4,6 @@ obj/
 .idea/
 artifacts
 
+test-site.html
+test-site-new.html
 RELEASE_GUIDE.md

Jellyfin.Plugin.Seasonals/Api/SeasonalsController.cs

@@ -3,6 +3,8 @@ using System.IO;
 using System.Reflection;
 using System.Text;
 using Microsoft.AspNetCore.Mvc;
+using Jellyfin.Plugin.Seasonals;
+using Jellyfin.Plugin.Seasonals.Configuration;
 
 namespace Jellyfin.Plugin.Seasonals.Api;
 
@@ -19,14 +21,9 @@ public class SeasonalsController : ControllerBase
     /// <returns>The configuration object.</returns>
     [HttpGet("Config")]
     [Produces("application/json")]
-    public ActionResult<object> GetConfig()
+    public ActionResult<PluginConfiguration> GetConfig()
     {
-        var config = Plugin.Instance?.Configuration;
+        return SeasonalsPlugin.Instance?.Configuration ?? new PluginConfiguration();
-        return new
-        {
-            selectedSeason = config?.SelectedSeason ?? "none",
-            automateSeasonSelection = config?.AutomateSeasonSelection ?? true
-        };
     }
 
     /// <summary>
@@ -43,7 +40,7 @@ public class SeasonalsController : ControllerBase
             return BadRequest();
         }
 
-        var assembly = Assembly.GetExecutingAssembly();
+        var assembly = typeof(SeasonalsPlugin).Assembly;
         // Convert path to resource name
         var resourcePath = path.Replace('/', '.').Replace('\\', '.');
         var resourceName = $"Jellyfin.Plugin.Seasonals.Web.{resourcePath}";
@@ -65,6 +62,7 @@ public class SeasonalsController : ControllerBase
         if (path.EndsWith(".png", StringComparison.OrdinalIgnoreCase)) return "image/png";
         if (path.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase)) return "image/jpeg";
         if (path.EndsWith(".gif", StringComparison.OrdinalIgnoreCase)) return "image/gif";
+        if (path.EndsWith(".svg", StringComparison.OrdinalIgnoreCase)) return "image/svg+xml";
         return "application/octet-stream";
     }
 }

Jellyfin.Plugin.Seasonals/Configuration/PluginConfiguration.cs

@@ -12,10 +12,28 @@ public class PluginConfiguration : BasePluginConfiguration
     /// </summary>
     public PluginConfiguration()
     {
+        IsEnabled = true;
         SelectedSeason = "none";
         AutomateSeasonSelection = true;
+        EnableClientSideToggle = true;
+        
+        Autumn = new AutumnOptions();
+        Snowflakes = new SnowflakesOptions();
+        Snowfall = new SnowfallOptions();
+        Snowstorm = new SnowstormOptions();
+        Fireworks = new FireworksOptions();
+        Halloween = new HalloweenOptions();
+        Hearts = new HeartsOptions();
+        Christmas = new ChristmasOptions();
+        Santa = new SantaOptions();
+        Easter = new EasterOptions();
     }
 
+    /// <summary>
+    /// Gets or sets a value indicating whether the plugin is enabled.
+    /// </summary>
+    public bool IsEnabled { get; set; }
+
     /// <summary>
     /// Gets or sets the selected season.
     /// </summary>
@@ -25,4 +43,126 @@ public class PluginConfiguration : BasePluginConfiguration
     /// Gets or sets a value indicating whether to automate season selection.
     /// </summary>
     public bool AutomateSeasonSelection { get; set; }
+
+    /// <summary>
+    /// Gets or sets a value indicating whether to enable client-side toggle for users.
+    /// </summary>
+    public bool EnableClientSideToggle { get; set; }
+
+    /// <summary>
+    /// Gets or sets the Seasonals options.
+    /// </summary>
+    public AutumnOptions Autumn { get; set; }
+    public SnowflakesOptions Snowflakes { get; set; }
+    public SnowfallOptions Snowfall { get; set; }
+    public SnowstormOptions Snowstorm { get; set; }
+    public FireworksOptions Fireworks { get; set; }
+    public HalloweenOptions Halloween { get; set; }
+    public HeartsOptions Hearts { get; set; }
+    public ChristmasOptions Christmas { get; set; }
+    public SantaOptions Santa { get; set; }
+    public EasterOptions Easter { get; set; }
+}
+
+public class AutumnOptions
+{
+    public int LeafCount { get; set; } = 25;
+    public bool EnableAutumn { get; set; } = true;
+    public bool EnableRandomLeaves { get; set; } = true;
+    public bool EnableRandomLeavesMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public bool EnableRotation { get; set; } = false;
+}
+
+public class SnowflakesOptions
+{
+    public int SnowflakeCount { get; set; } = 25;
+    public bool EnableSnowflakes { get; set; } = true;
+    public bool EnableRandomSnowflakes { get; set; } = true;
+    public bool EnableRandomSnowflakesMobile { get; set; } = false;
+    public bool EnableColoredSnowflakes { get; set; } = true;
+    public bool EnableDifferentDuration { get; set; } = true;
+}
+
+public class SnowfallOptions
+{
+    public int SnowflakesCount { get; set; } = 500;
+    public int SnowflakesCountMobile { get; set; } = 250;
+    public double Speed { get; set; } = 3;
+    public bool EnableSnowfall { get; set; } = true;
+}
+
+public class SnowstormOptions
+{
+    public int SnowflakesCount { get; set; } = 500;
+    public int SnowflakesCountMobile { get; set; } = 250;
+    public double Speed { get; set; } = 6;
+    public bool EnableSnowstorm { get; set; } = true;
+    public double HorizontalWind { get; set; } = 4;
+    public double VerticalVariation { get; set; } = 2;
+}
+
+public class FireworksOptions
+{
+    public int ParticleCount { get; set; } = 50;
+    public int LaunchInterval { get; set; } = 3200;
+    public bool EnableFireworks { get; set; } = true;
+    public bool ScrollFireworks { get; set; } = true;
+    public int MinFireworks { get; set; } = 3;
+    public int MaxFireworks { get; set; } = 6;
+}
+
+public class HalloweenOptions
+{
+    public int SymbolCount { get; set; } = 25;
+    public bool EnableHalloween { get; set; } = true;
+    public bool EnableRandomSymbols { get; set; } = true;
+    public bool EnableRandomSymbolsMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+}
+
+public class HeartsOptions
+{
+    public int SymbolCount { get; set; } = 25;
+    public bool EnableHearts { get; set; } = true;
+    public bool EnableRandomSymbols { get; set; } = true;
+    public bool EnableRandomSymbolsMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+}
+
+public class ChristmasOptions
+{
+    public int SymbolCount { get; set; } = 25;
+    public bool EnableChristmas { get; set; } = true;
+    public bool EnableRandomChristmas { get; set; } = true;
+    public bool EnableRandomChristmasMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+}
+
+public class SantaOptions
+{
+    public int SnowflakesCount { get; set; } = 500;
+    public int SnowflakesCountMobile { get; set; } = 250;
+    public double SantaSpeed { get; set; } = 10;
+    public double SantaSpeedMobile { get; set; } = 8;
+    public bool EnableSanta { get; set; } = true;
+    public double SnowFallSpeed { get; set; } = 3;
+    public double MaxSantaRestTime { get; set; } = 8;
+    public double MinSantaRestTime { get; set; } = 3;
+    public double MaxPresentFallSpeed { get; set; } = 5;
+    public double MinPresentFallSpeed { get; set; } = 2;
+}
+
+public class EasterOptions
+{
+    public int EggCount { get; set; } = 20;
+    public bool EnableEaster { get; set; } = true;
+    public bool EnableRandomEaster { get; set; } = true;
+    public bool EnableRandomEasterMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public bool EnableBunny { get; set; } = true;
+    public int BunnyDuration { get; set; } = 12000;
+    public int HopHeight { get; set; } = 12;
+    public int MinBunnyRestTime { get; set; } = 2000;
+    public int MaxBunnyRestTime { get; set; } = 5000;
 }

Jellyfin.Plugin.Seasonals/Configuration/configPage.html

@@ -2,13 +2,35 @@
 <html lang="en">
 <head>
     <meta charset="utf-8">
-    <title>Template</title>
+    <title>Seasonals Configuration</title>
 </head>
 <body>
     <div id="SeasonalsConfigPage" data-role="page" class="page type-interior pluginConfigurationPage" data-require="emby-input,emby-button,emby-select,emby-checkbox">
+        <style>
+            select option:disabled {
+                color: #a3a3a3 !important;
+            }
+        </style>
         <div data-role="content">
             <div class="content-primary">
+                <div class="sectionTitleContainer">
+                    <h2 class="sectionTitle">Seasonals</h2>
+                    <a is="emby-linkbutton" class="raised raised-mini emby-button" style="margin-left: 2em;"
+                        target="_blank" href="https://github.com/CodeDevMLH/Jellyfin-Seasonals">
+                        <i class="md-icon button-icon button-icon-left secondaryText"></i>
+                        <span>${Help}</span>
+                    </a>
+                </div>
+                <hr style="max-width: 800px; margin: 1em 0;">
+                <br>
                 <form id="SeasonalsConfigForm">
+                    <div class="checkboxContainer checkboxContainer-withDescription">
+                        <label class="emby-checkbox-label">
+                            <input id="IsEnabled" name="IsEnabled" type="checkbox" is="emby-checkbox" />
+                            <span>Enable Seasonals</span>
+                        </label>
+                        <div class="fieldDescription">Enable or disable the entire plugin functionality.</div>
+                    </div>
                     <div class="checkboxContainer checkboxContainer-withDescription">
                         <label class="emby-checkbox-label">
                             <input id="AutomateSeasonSelection" name="AutomateSeasonSelection" type="checkbox" is="emby-checkbox" />
@@ -18,7 +40,7 @@
                     </div>
                     <div class="selectContainer">
                         <label class="selectLabel" for="SelectedSeason">Selected Season</label>
-                        <select is="emby-select" id="SelectedSeason" name="SelectedSeason" class="emby-select-withcolor emby-select">
+                        <select id="SelectedSeason" name="SelectedSeason" class="emby-select" style="width: 100%; padding: 0.5em; background-color: #333; border: 1px solid #444; color: #fff; border-radius: 4px;">
                             <option value="none">None</option>
                             <option value="snowflakes">Snowflakes</option>
                             <option value="snowfall">Snowfall</option>
@@ -30,14 +52,476 @@
                             <option value="santa">Santa</option>
                             <option value="autumn">Autumn</option>
                             <option value="easter">Easter</option>
+                            <option value="summer" disabled>Summer (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="spring" disabled>Spring (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="oktoberfest" disabled>Oktoberfest (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="carnival" disabled>Carnival (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="championships" disabled>European/World Championships (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="patrick" disabled>St. Patrick's Day (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="thanksgiving" disabled>Thanksgiving (not implemented yet. Please commit ideas in a issue or PR)</option>
+                            <option value="pride" disabled>Pride (not implemented yet. Please commit ideas in a issue or PR)</option>
                         </select>
                         <div class="fieldDescription">The season to display if automation is disabled.</div>
                     </div>
+                    <div class="checkboxContainer checkboxContainer-withDescription">
+                        <label class="emby-checkbox-label">
+                            <input id="EnableClientSideToggle" name="EnableClientSideToggle" type="checkbox"
+                                is="emby-checkbox" />
+                            <span>Allow Client-Side Toggle</span>
+                        </label>
+                        <div class="fieldDescription">If enabled, users will see a seasonals icon in the header to toggle seasonals for their browser (device-specific).</div>
+                    </div>
+                    <br>
+
+                    <details>
+                        <summary>Advanced Configuration</summary>
+                        <p>Configure specific settings for each seasonal theme below.</p>
+                        <p>All symbol count settings add this number in addition to the standard 12 symbols (if additional symbols is enabled).</p>
+                        
+                        <details>
+                            <summary>Autumn</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableAutumn" name="EnableAutumn" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Autumn Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the autumn theme effects in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomLeaves" name="EnableRandomLeaves" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Leaves</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional leaves randomly distributed across the screen</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomLeavesMobile" name="EnableRandomLeavesMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Leaves on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional leaves randomly distributed across the screen on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="AutumnLeafCount">Leaf Count</label>
+                                <input is="emby-input" type="number" id="AutumnLeafCount" name="AutumnLeafCount" />
+                                <div class="fieldDescription">Number of additional leaves displayed on screen (if enabled)</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationAutumn" name="EnableDifferentDurationAutumn" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the falling speed of each leaf.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRotation" name="EnableRotation" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Rotation</span>
+                                </label>
+                                <div class="fieldDescription">Rotate leaves as they fall. Notice: May affect performance</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Snowflakes</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableSnowflakes" name="EnableSnowflakes" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Snowflakes Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the snowflakes theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomSnowflakes" name="EnableRandomSnowflakes" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Snowflakes</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional snowflakes randomly distributed across the screen.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomSnowflakesMobile" name="EnableRandomSnowflakesMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Snowflakes on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional snowflakes randomly distributed across the screen on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowflakesCount">Snowflake Count</label>
+                                <input is="emby-input" type="number" id="SnowflakesCount" name="SnowflakesCount" />
+                                <div class="fieldDescription">Number of additional snowflakes displayed (if enabled).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableColoredSnowflakes" name="EnableColoredSnowflakes" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Colored Snowflakes</span>
+                                </label>
+                                <div class="fieldDescription">Display snowflakes in different colors/shapes.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationSnowflakes" name="EnableDifferentDurationSnowflakes" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the falling speed of snowflakes.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Snowfall</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableSnowfall" name="EnableSnowfall" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Snowfall Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the snowfall effect in general (e.g. for automation).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowfallCount">Snowflake Count</label>
+                                <input is="emby-input" type="number" id="SnowfallCount" name="SnowfallCount" />
+                                <div class="fieldDescription">Total number of snowflakes for the snowfall effect (recommended values: 300 - 600).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowfallCountMobile">Snowflake Count (Mobile)</label>
+                                <input is="emby-input" type="number" id="SnowfallCountMobile" name="SnowfallCountMobile" />
+                                <div class="fieldDescription">Total number of snowflakes on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowfallSpeed">Speed</label>
+                                <input is="emby-input" type="number" id="SnowfallSpeed" name="SnowfallSpeed" step="0.1" />
+                                <div class="fieldDescription">The speed of the snowfall animation (recommended values: 0 - 5).</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Snowstorm</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableSnowstorm" name="EnableSnowstorm" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Snowstorm Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the snowstorm effect in general (e.g. for automation).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowstormCount">Snowflake Count</label>
+                                <input is="emby-input" type="number" id="SnowstormCount" name="SnowstormCount" />
+                                <div class="fieldDescription">Total number of snowflakes in the storm (recommended values: 300 - 600).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowstormCountMobile">Snowflake Count (Mobile)</label>
+                                <input is="emby-input" type="number" id="SnowstormCountMobile" name="SnowstormCountMobile" />
+                                <div class="fieldDescription">Total number of snowflakes on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowstormSpeed">Speed</label>
+                                <input is="emby-input" type="number" id="SnowstormSpeed" name="SnowstormSpeed" step="0.1" />
+                                <div class="fieldDescription">The speed of the snowstorm (falling).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowstormHorizontalWind">Horizontal Wind</label>
+                                <input is="emby-input" type="number" id="SnowstormHorizontalWind" name="SnowstormHorizontalWind" step="0.1" />
+                                <div class="fieldDescription">Strength of the horizontal wind effect (recommended values: 3 - 6).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SnowstormVerticalVariation">Vertical Variation</label>
+                                <input is="emby-input" type="number" id="SnowstormVerticalVariation" name="SnowstormVerticalVariation" step="0.1" />
+                                <div class="fieldDescription">Amount of vertical movement variation (recommended values: 1 - 3).</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Fireworks</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableFireworks" name="EnableFireworks" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Fireworks Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the fireworks effect in general (e.g. for automation).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="FireworksParticles">Particle Count</label>
+                                <input is="emby-input" type="number" id="FireworksParticles" name="FireworksParticles" />
+                                <div class="fieldDescription">Number of particles per firework explosion. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="FireworksInterval">Launch Interval (ms)</label>
+                                <input is="emby-input" type="number" id="FireworksInterval" name="FireworksInterval" />
+                                <div class="fieldDescription">Time in milliseconds between firework launches.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="ScrollFireworks" name="ScrollFireworks" type="checkbox" is="emby-checkbox" />
+                                    <span>Scroll Fireworks</span>
+                                </label>
+                                <div class="fieldDescription">Allow fireworks to scroll with the page.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MinFireworks">Min Fireworks</label>
+                                <input is="emby-input" type="number" id="MinFireworks" name="MinFireworks" />
+                                <div class="fieldDescription">Minimum number of concurrent fireworks.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MaxFireworks">Max Fireworks</label>
+                                <input is="emby-input" type="number" id="MaxFireworks" name="MaxFireworks" />
+                                <div class="fieldDescription">Maximum number of concurrent fireworks.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Halloween</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableHalloween" name="EnableHalloween" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Halloween Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the Halloween theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomHalloween" name="EnableRandomHalloween" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Symbols</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional Halloween symbols randomly distributed across the screen.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomHalloweenMobile" name="EnableRandomHalloweenMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Symbols on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional Halloween symbols randomly distributed across the screen on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="HalloweenCount">Symbol Count</label>
+                                <input is="emby-input" type="number" id="HalloweenCount" name="HalloweenCount" />
+                                <div class="fieldDescription">Number of additional Halloween symbols (pumpkins, ghosts, etc.) on screen (if enabled).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationHalloween" name="EnableDifferentDurationHalloween" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the movement speed.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Hearts</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableHearts" name="EnableHearts" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Hearts Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the Hearts theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomHearts" name="EnableRandomHearts" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Symbols</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional hearts randomly distributed across the screen.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomHeartsMobile" name="EnableRandomHeartsMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Symbols on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional hearts randomly distributed across the screen. on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="HeartsCount">Symbol Count</label>
+                                <input is="emby-input" type="number" id="HeartsCount" name="HeartsCount" />
+                                <div class="fieldDescription">Number of additional floating hearts.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationHearts" name="EnableDifferentDurationHearts" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the floating speed.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Christmas</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableChristmas" name="EnableChristmas" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Christmas Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the Christmas theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomChristmas" name="EnableRandomChristmas" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Christmas</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional Christmas-themed icons randomly distributed across the screen.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomChristmasMobile" name="EnableRandomChristmasMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Christmas on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional Christmas-themed icons randomly distributed across the screen on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="ChristmasCount">Symbol Count</label>
+                                <input is="emby-input" type="number" id="ChristmasCount" name="ChristmasCount" />
+                                <div class="fieldDescription">Number of additional Christmas symbols.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationChristmas" name="EnableDifferentDurationChristmas" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the movement speed.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Santa</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableSanta" name="EnableSanta" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Santa Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the Santa theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SantaSnowflakes">Snowflakes Count</label>
+                                <input is="emby-input" type="number" id="SantaSnowflakes" name="SantaSnowflakes" />
+                                <div class="fieldDescription">Number of snowflakes accompanying Santa (recommended values: 300-600).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SantaSnowflakesMobile">Snowflakes Count (Mobile)</label>
+                                <input is="emby-input" type="number" id="SantaSnowflakesMobile" name="SantaSnowflakesMobile" />
+                                <div class="fieldDescription">Number of snowflakes accompanying Santa on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SantaSpeed">Santa Speed (seconds)</label>
+                                <input is="emby-input" type="number" id="SantaSpeed" name="SantaSpeed" step="0.1" />
+                                <div class="fieldDescription">Time in seconds for Santa to cross the screen (recommended values: 5 - 15).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SantaSpeedMobile">Santa Speed Mobile (seconds)</label>
+                                <input is="emby-input" type="number" id="SantaSpeedMobile" name="SantaSpeedMobile" step="0.1" />
+                                <div class="fieldDescription">Time in seconds for Santa to cross the screen on mobile (recommended values: 3 - 12).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="SantaSnowFallSpeed">Snowfall Speed</label>
+                                <input is="emby-input" type="number" id="SantaSnowFallSpeed" name="SantaSnowFallSpeed" step="0.1" />
+                                <div class="fieldDescription">Speed of the falling snow (recommended values: 0-5).</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MaxSantaRestTime">Max Santa Rest Time (seconds)</label>
+                                <input is="emby-input" type="number" id="MaxSantaRestTime" name="MaxSantaRestTime" step="0.1" />
+                                <div class="fieldDescription">Maximum time Santa waits before appearing again.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MinSantaRestTime">Min Santa Rest Time (seconds)</label>
+                                <input is="emby-input" type="number" id="MinSantaRestTime" name="MinSantaRestTime" step="0.1" />
+                                <div class="fieldDescription">Minimum time Santa waits before appearing again.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MaxPresentFallSpeed">Max Present Fall Speed (seconds)</label>
+                                <input is="emby-input" type="number" id="MaxPresentFallSpeed" name="MaxPresentFallSpeed" step="0.1" />
+                                <div class="fieldDescription">Maximum speed of falling presents.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MinPresentFallSpeed">Min Present Fall Speed (seconds)</label>
+                                <input is="emby-input" type="number" id="MinPresentFallSpeed" name="MinPresentFallSpeed" step="0.1" />
+                                <div class="fieldDescription">Minimum speed of falling presents.</div>
+                            </div>
+                        </details>
+                        <hr style="max-width: 800px; margin: 1em 0;">
+
+                        <details>
+                            <summary>Easter</summary>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableEaster" name="EnableEaster" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Easter Seasonal</span>
+                                </label>
+                                <div class="fieldDescription">Enable the Easter theme in general (e.g. for automation).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomEaster" name="EnableRandomEaster" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Easter Eggs</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional easter eggs randomly distributed across the screen.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableRandomEasterMobile" name="EnableRandomEasterMobile" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Additional Random Easter Eggs on Mobile</span>
+                                </label>
+                                <div class="fieldDescription">Displays additional easter eggs randomly distributed across the screen on mobile devices. Warning: High values may affect performance.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="EasterEggCount">Egg Count</label>
+                                <input is="emby-input" type="number" id="EasterEggCount" name="EasterEggCount" />
+                                <div class="fieldDescription">Number of additional Easter eggs (if enabled).</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EnableDifferentDurationEaster" name="EnableDifferentDurationEaster" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Different Duration</span>
+                                </label>
+                                <div class="fieldDescription">Randomize the movement speed.</div>
+                            </div>
+                            <div class="checkboxContainer checkboxContainer-withDescription">
+                                <label class="emby-checkbox-label">
+                                    <input id="EasterBunny" name="EasterBunny" type="checkbox" is="emby-checkbox" />
+                                    <span>Enable Bunny</span>
+                                </label>
+                                <div class="fieldDescription">Show the Easter Bunny hopping across the screen.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="BunnyDuration">Bunny Duration (ms)</label>
+                                <input is="emby-input" type="number" id="BunnyDuration" name="BunnyDuration" />
+                                <div class="fieldDescription">Time in milliseconds for one hop cycle.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="HopHeight">Hop Height (px)</label>
+                                <input is="emby-input" type="number" id="HopHeight" name="HopHeight" />
+                                <div class="fieldDescription">Height of the bunny's hop in pixels.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MinBunnyRestTime">Min Bunny Rest Time (ms)</label>
+                                <input is="emby-input" type="number" id="MinBunnyRestTime" name="MinBunnyRestTime" />
+                                <div class="fieldDescription">Minimum time the bunny waits before appearing again.</div>
+                            </div>
+                            <div class="inputContainer">
+                                <label class="inputLabel" for="MaxBunnyRestTime">Max Bunny Rest Time (ms)</label>
+                                <input is="emby-input" type="number" id="MaxBunnyRestTime" name="MaxBunnyRestTime" />
+                                <div class="fieldDescription">Maximum time the bunny waits before appearing again.</div>
+                            </div>
+                        </details>
+                    </details>
+
+                    <div style="background-color: rgba(255, 255, 255, 0.05); border-left: 4px solid #00a4dc; border-radius: 4px; padding: 1em 1.5em; margin: 1.5em 0; display: flex; align-items: center; gap: 1em;">
+                        <i class="material-icons" style="color: #00a4dc; font-size: 24px;">info</i>
+                        <div>
+                            All changes require a page refresh (ctrl + r or F5) after saving for changes to take effect. <br/>
+                            If old settings persist, please force clear browser cache.
+                        </div>
+                    </div>
+
                     <div>
                         <button is="emby-button" type="submit" class="raised button-submit block emby-button">
-                            <span>Save</span>
+                            <span>${Save}</span>
+                        </button>
+                        <button is="emby-button" type="button" class="raised button-cancel block btnCancel" onclick="history.back();">
+                            <span>${ButtonCancel}</span>
                         </button>
-                        <div class="fieldDescription" style="margin-top: 1em;">Please reload the page (F5) after saving for changes to take effect.</div>
                     </div>
                 </form>
             </div>
@@ -51,8 +535,95 @@
                 .addEventListener('pageshow', function() {
                     Dashboard.showLoadingMsg();
                     ApiClient.getPluginConfiguration(SeasonalsConfig.pluginUniqueId).then(function (config) {
+                        document.querySelector('#IsEnabled').checked = config.IsEnabled;
                         document.querySelector('#SelectedSeason').value = config.SelectedSeason;
                         document.querySelector('#AutomateSeasonSelection').checked = config.AutomateSeasonSelection;
+                        document.querySelector('#EnableClientSideToggle').checked = config.EnableClientSideToggle !== undefined ? config.EnableClientSideToggle : true;
+
+                        // Advanced Config
+                        // Autumn
+                        document.querySelector('#EnableAutumn').checked = config.Autumn.EnableAutumn;
+                        document.querySelector('#AutumnLeafCount').value = config.Autumn.LeafCount;
+                        document.querySelector('#EnableRandomLeaves').checked = config.Autumn.EnableRandomLeaves;
+                        document.querySelector('#EnableRandomLeavesMobile').checked = config.Autumn.EnableRandomLeavesMobile;
+                        document.querySelector('#EnableDifferentDurationAutumn').checked = config.Autumn.EnableDifferentDuration;
+                        document.querySelector('#EnableRotation').checked = config.Autumn.EnableRotation;
+
+                        // Snowflakes
+                        document.querySelector('#SnowflakesCount').value = config.Snowflakes.SnowflakeCount;
+                        document.querySelector('#EnableSnowflakes').checked = config.Snowflakes.EnableSnowflakes;
+                        document.querySelector('#EnableRandomSnowflakes').checked = config.Snowflakes.EnableRandomSnowflakes;
+                        document.querySelector('#EnableRandomSnowflakesMobile').checked = config.Snowflakes.EnableRandomSnowflakesMobile;
+                        document.querySelector('#EnableColoredSnowflakes').checked = config.Snowflakes.EnableColoredSnowflakes;
+                        document.querySelector('#EnableDifferentDurationSnowflakes').checked = config.Snowflakes.EnableDifferentDuration;
+
+                        // Snowfall
+                        document.querySelector('#EnableSnowfall').checked = config.Snowfall.EnableSnowfall;
+                        document.querySelector('#SnowfallCount').value = config.Snowfall.SnowflakesCount;
+                        document.querySelector('#SnowfallCountMobile').value = config.Snowfall.SnowflakesCountMobile;
+                        document.querySelector('#SnowfallSpeed').value = config.Snowfall.Speed;
+
+                        // Snowstorm
+                        document.querySelector('#EnableSnowstorm').checked = config.Snowstorm.EnableSnowstorm;
+                        document.querySelector('#SnowstormCount').value = config.Snowstorm.SnowflakesCount;
+                        document.querySelector('#SnowstormCountMobile').value = config.Snowstorm.SnowflakesCountMobile;
+                        document.querySelector('#SnowstormSpeed').value = config.Snowstorm.Speed;
+                        document.querySelector('#SnowstormHorizontalWind').value = config.Snowstorm.HorizontalWind;
+                        document.querySelector('#SnowstormVerticalVariation').value = config.Snowstorm.VerticalVariation;
+
+                        // Fireworks
+                        document.querySelector('#EnableFireworks').checked = config.Fireworks.EnableFireworks;
+                        document.querySelector('#FireworksParticles').value = config.Fireworks.ParticleCount;
+                        document.querySelector('#FireworksInterval').value = config.Fireworks.LaunchInterval;
+                        document.querySelector('#ScrollFireworks').checked = config.Fireworks.ScrollFireworks;
+                        document.querySelector('#MinFireworks').value = config.Fireworks.MinFireworks;
+                        document.querySelector('#MaxFireworks').value = config.Fireworks.MaxFireworks;
+
+                        // Halloween
+                        document.querySelector('#EnableHalloween').checked = config.Halloween.EnableHalloween;
+                        document.querySelector('#HalloweenCount').value = config.Halloween.SymbolCount;
+                        document.querySelector('#EnableRandomHalloween').checked = config.Halloween.EnableRandomSymbols;
+                        document.querySelector('#EnableRandomHalloweenMobile').checked = config.Halloween.EnableRandomSymbolsMobile;
+                        document.querySelector('#EnableDifferentDurationHalloween').checked = config.Halloween.EnableDifferentDuration;
+
+                        // Hearts
+                        document.querySelector('#EnableHearts').checked = config.Hearts.EnableHearts;
+                        document.querySelector('#HeartsCount').value = config.Hearts.SymbolCount;
+                        document.querySelector('#EnableRandomHearts').checked = config.Hearts.EnableRandomSymbols;
+                        document.querySelector('#EnableRandomHeartsMobile').checked = config.Hearts.EnableRandomSymbolsMobile;
+                        document.querySelector('#EnableDifferentDurationHearts').checked = config.Hearts.EnableDifferentDuration;
+
+                        // Christmas
+                        document.querySelector('#EnableChristmas').checked = config.Christmas.EnableChristmas;
+                        document.querySelector('#ChristmasCount').value = config.Christmas.SymbolCount;
+                        document.querySelector('#EnableRandomChristmas').checked = config.Christmas.EnableRandomChristmas;
+                        document.querySelector('#EnableRandomChristmasMobile').checked = config.Christmas.EnableRandomChristmasMobile;
+                        document.querySelector('#EnableDifferentDurationChristmas').checked = config.Christmas.EnableDifferentDuration;
+
+                        // Santa
+                        document.querySelector('#EnableSanta').checked = config.Santa.EnableSanta;
+                        document.querySelector('#SantaSnowflakes').value = config.Santa.SnowflakesCount;
+                        document.querySelector('#SantaSnowflakesMobile').value = config.Santa.SnowflakesCountMobile;
+                        document.querySelector('#SantaSpeed').value = config.Santa.SantaSpeed;
+                        document.querySelector('#SantaSpeedMobile').value = config.Santa.SantaSpeedMobile;
+                        document.querySelector('#SantaSnowFallSpeed').value = config.Santa.SnowFallSpeed;
+                        document.querySelector('#MaxSantaRestTime').value = config.Santa.MaxSantaRestTime;
+                        document.querySelector('#MinSantaRestTime').value = config.Santa.MinSantaRestTime;
+                        document.querySelector('#MaxPresentFallSpeed').value = config.Santa.MaxPresentFallSpeed;
+                        document.querySelector('#MinPresentFallSpeed').value = config.Santa.MinPresentFallSpeed;
+
+                        // Easter
+                        document.querySelector('#EnableEaster').checked = config.Easter.EnableEaster;
+                        document.querySelector('#EasterEggCount').value = config.Easter.EggCount;
+                        document.querySelector('#EnableRandomEaster').checked = config.Easter.EnableRandomEaster;
+                        document.querySelector('#EnableRandomEasterMobile').checked = config.Easter.EnableRandomEasterMobile;
+                        document.querySelector('#EnableDifferentDurationEaster').checked = config.Easter.EnableDifferentDuration;
+                        document.querySelector('#EasterBunny').checked = config.Easter.EnableBunny;
+                        document.querySelector('#BunnyDuration').value = config.Easter.BunnyDuration;
+                        document.querySelector('#HopHeight').value = config.Easter.HopHeight;
+                        document.querySelector('#MinBunnyRestTime').value = config.Easter.MinBunnyRestTime;
+                        document.querySelector('#MaxBunnyRestTime').value = config.Easter.MaxBunnyRestTime;
+
                         Dashboard.hideLoadingMsg();
                     });
                 });
@@ -61,8 +632,96 @@
                 .addEventListener('submit', function(e) {
                     Dashboard.showLoadingMsg();
                     ApiClient.getPluginConfiguration(SeasonalsConfig.pluginUniqueId).then(function (config) {
+                        config.IsEnabled = document.querySelector('#IsEnabled').checked;
                         config.SelectedSeason = document.querySelector('#SelectedSeason').value;
                         config.AutomateSeasonSelection = document.querySelector('#AutomateSeasonSelection').checked;
+                        config.EnableClientSideToggle = document.querySelector('#EnableClientSideToggle').checked;
+
+
+                        // Advanced Config
+                        // Autumn
+                        config.Autumn.EnableAutumn = document.querySelector('#EnableAutumn').checked;
+                        config.Autumn.LeafCount = parseInt(document.querySelector('#AutumnLeafCount').value);
+                        config.Autumn.EnableRandomLeaves = document.querySelector('#EnableRandomLeaves').checked;
+                        config.Autumn.EnableRandomLeavesMobile = document.querySelector('#EnableRandomLeavesMobile').checked;
+                        config.Autumn.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationAutumn').checked;
+                        config.Autumn.EnableRotation = document.querySelector('#EnableRotation').checked;
+
+                        // Snowflakes
+                        config.Snowflakes.SnowflakeCount = parseInt(document.querySelector('#SnowflakesCount').value);
+                        config.Snowflakes.EnableSnowflakes = document.querySelector('#EnableSnowflakes').checked;
+                        config.Snowflakes.EnableRandomSnowflakes = document.querySelector('#EnableRandomSnowflakes').checked;
+                        config.Snowflakes.EnableRandomSnowflakesMobile = document.querySelector('#EnableRandomSnowflakesMobile').checked;
+                        config.Snowflakes.EnableColoredSnowflakes = document.querySelector('#EnableColoredSnowflakes').checked;
+                        config.Snowflakes.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationSnowflakes').checked;
+
+                        // Snowfall
+                        config.Snowfall.EnableSnowfall = document.querySelector('#EnableSnowfall').checked;
+                        config.Snowfall.SnowflakesCount = parseInt(document.querySelector('#SnowfallCount').value);
+                        config.Snowfall.SnowflakesCountMobile = parseInt(document.querySelector('#SnowfallCountMobile').value);
+                        config.Snowfall.Speed = parseFloat(document.querySelector('#SnowfallSpeed').value);
+
+                        // Snowstorm
+                        config.Snowstorm.EnableSnowstorm = document.querySelector('#EnableSnowstorm').checked;
+                        config.Snowstorm.SnowflakesCount = parseInt(document.querySelector('#SnowstormCount').value);
+                        config.Snowstorm.SnowflakesCountMobile = parseInt(document.querySelector('#SnowstormCountMobile').value);
+                        config.Snowstorm.Speed = parseFloat(document.querySelector('#SnowstormSpeed').value);
+                        config.Snowstorm.HorizontalWind = parseFloat(document.querySelector('#SnowstormHorizontalWind').value);
+                        config.Snowstorm.VerticalVariation = parseFloat(document.querySelector('#SnowstormVerticalVariation').value);
+
+                        // Fireworks
+                        config.Fireworks.EnableFireworks = document.querySelector('#EnableFireworks').checked;
+                        config.Fireworks.ParticleCount = parseInt(document.querySelector('#FireworksParticles').value);
+                        config.Fireworks.LaunchInterval = parseInt(document.querySelector('#FireworksInterval').value);
+                        config.Fireworks.ScrollFireworks = document.querySelector('#ScrollFireworks').checked;
+                        config.Fireworks.MinFireworks = parseInt(document.querySelector('#MinFireworks').value);
+                        config.Fireworks.MaxFireworks = parseInt(document.querySelector('#MaxFireworks').value);
+
+                        // Halloween
+                        config.Halloween.EnableHalloween = document.querySelector('#EnableHalloween').checked;
+                        config.Halloween.SymbolCount = parseInt(document.querySelector('#HalloweenCount').value);
+                        config.Halloween.EnableRandomSymbols = document.querySelector('#EnableRandomHalloween').checked;
+                        config.Halloween.EnableRandomSymbolsMobile = document.querySelector('#EnableRandomHalloweenMobile').checked;
+                        config.Halloween.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationHalloween').checked;
+
+                        // Hearts
+                        config.Hearts.EnableHearts = document.querySelector('#EnableHearts').checked;
+                        config.Hearts.SymbolCount = parseInt(document.querySelector('#HeartsCount').value);
+                        config.Hearts.EnableRandomSymbols = document.querySelector('#EnableRandomHearts').checked;
+                        config.Hearts.EnableRandomSymbolsMobile = document.querySelector('#EnableRandomHeartsMobile').checked;
+                        config.Hearts.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationHearts').checked;
+
+                        // Christmas
+                        config.Christmas.EnableChristmas = document.querySelector('#EnableChristmas').checked;
+                        config.Christmas.SymbolCount = parseInt(document.querySelector('#ChristmasCount').value);
+                        config.Christmas.EnableRandomChristmas = document.querySelector('#EnableRandomChristmas').checked;
+                        config.Christmas.EnableRandomChristmasMobile = document.querySelector('#EnableRandomChristmasMobile').checked;
+                        config.Christmas.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationChristmas').checked;
+
+                        // Santa
+                        config.Santa.EnableSanta = document.querySelector('#EnableSanta').checked;
+                        config.Santa.SnowflakesCount = parseInt(document.querySelector('#SantaSnowflakes').value);
+                        config.Santa.SnowflakesCountMobile = parseInt(document.querySelector('#SantaSnowflakesMobile').value);
+                        config.Santa.SantaSpeed = parseFloat(document.querySelector('#SantaSpeed').value);
+                        config.Santa.SantaSpeedMobile = parseFloat(document.querySelector('#SantaSpeedMobile').value);
+                        config.Santa.SnowFallSpeed = parseFloat(document.querySelector('#SantaSnowFallSpeed').value);
+                        config.Santa.MaxSantaRestTime = parseFloat(document.querySelector('#MaxSantaRestTime').value);
+                        config.Santa.MinSantaRestTime = parseFloat(document.querySelector('#MinSantaRestTime').value);
+                        config.Santa.MaxPresentFallSpeed = parseFloat(document.querySelector('#MaxPresentFallSpeed').value);
+                        config.Santa.MinPresentFallSpeed = parseFloat(document.querySelector('#MinPresentFallSpeed').value);
+
+                        // Easter
+                        config.Easter.EnableEaster = document.querySelector('#EnableEaster').checked;
+                        config.Easter.EggCount = parseInt(document.querySelector('#EasterEggCount').value);
+                        config.Easter.EnableRandomEaster = document.querySelector('#EnableRandomEaster').checked;
+                        config.Easter.EnableRandomEasterMobile = document.querySelector('#EnableRandomEasterMobile').checked;
+                        config.Easter.EnableDifferentDuration = document.querySelector('#EnableDifferentDurationEaster').checked;
+                        config.Easter.EnableBunny = document.querySelector('#EasterBunny').checked;
+                        config.Easter.BunnyDuration = parseInt(document.querySelector('#BunnyDuration').value);
+                        config.Easter.HopHeight = parseInt(document.querySelector('#HopHeight').value);
+                        config.Easter.MinBunnyRestTime = parseInt(document.querySelector('#MinBunnyRestTime').value);
+                        config.Easter.MaxBunnyRestTime = parseInt(document.querySelector('#MaxBunnyRestTime').value);
+
                         ApiClient.updatePluginConfiguration(SeasonalsConfig.pluginUniqueId, config).then(function (result) {
                             Dashboard.processPluginConfigurationUpdateResult(result);
                     });

Jellyfin.Plugin.Seasonals/Helpers/TransformationPatches.cs

@@ -0,0 +1,49 @@
+using System;
+using Jellyfin.Plugin.Seasonals.Model;
+
+namespace Jellyfin.Plugin.Seasonals.Helpers
+{
+    public static class TransformationPatches
+    {
+        public static string IndexHtml(PatchRequestPayload payload)
+        {
+            // Always return original content if something fails or is null
+            string? originalContents = payload?.Contents;
+            
+            if (string.IsNullOrEmpty(originalContents))
+            {
+                return originalContents ?? string.Empty;
+            }
+
+            try
+            {
+                
+                // Safety Check: If plugin is disabled, do nothing
+                if (SeasonalsPlugin.Instance?.Configuration.IsEnabled != true)
+                {
+                    return originalContents;
+                }
+
+                // Use StringBuilder for efficient modification
+                var builder = new System.Text.StringBuilder(originalContents);
+
+                // Inject Script if missing
+                if (!originalContents.Contains("seasonals.js", StringComparison.Ordinal))
+                {
+                    var scriptIndex = originalContents.LastIndexOf(ScriptInjector.Marker, StringComparison.OrdinalIgnoreCase);
+                    if (scriptIndex != -1)
+                    {
+                        builder.Insert(scriptIndex, ScriptInjector.ScriptTag + Environment.NewLine);
+                    }
+                }
+                
+                return builder.ToString();
+            }
+            catch
+            {
+                // On error, return original content to avoid breaking the UI
+                return originalContents;
+            }
+        }
+    }
+}

Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj

@@ -12,13 +12,14 @@
     <!-- <TreatWarningsAsErrors>false</TreatWarningsAsErrors> -->
     <Title>Jellyfin Seasonals Plugin</Title>
     <Authors>CodeDevMLH</Authors>
-    <Version>1.0.0.0</Version>
+    <Version>1.6.13.5</Version>
-    <RepositoryUrl>https://github.com/CodeDevMLH/jellyfin-plugin-seasonals</RepositoryUrl>
+    <RepositoryUrl>https://github.com/CodeDevMLH/Jellyfin-Seasonals</RepositoryUrl>
   </PropertyGroup>
 
   <ItemGroup>
     <PackageReference Include="Jellyfin.Controller" Version="$(JellyfinVersion)" />
     <PackageReference Include="Jellyfin.Model" Version="$(JellyfinVersion)" />
+    <PackageReference Include="Newtonsoft.Json" Version="13.0.4" />
   </ItemGroup>
 
   <ItemGroup>

Jellyfin.Plugin.Seasonals/Model/PatchRequestPayload.cs

@@ -0,0 +1,10 @@
+using System.Text.Json.Serialization;
+
+namespace Jellyfin.Plugin.Seasonals.Model
+{
+    public class PatchRequestPayload
+    {
+        [JsonPropertyName("contents")]
+        public string? Contents { get; set; }
+    }
+}

Jellyfin.Plugin.Seasonals/ScriptInjector.cs

@@ -1,8 +1,13 @@
 using System;
 using System.IO;
 using System.Reflection;
+using System.Runtime.Loader;
 using Microsoft.Extensions.Logging;
+using Newtonsoft.Json.Linq;
 using MediaBrowser.Common.Configuration;
+using Jellyfin.Plugin.Seasonals.Helpers;
+using System.Collections.Generic;
+using System.Linq;
 
 namespace Jellyfin.Plugin.Seasonals;
 
@@ -13,8 +18,8 @@ public class ScriptInjector
 {
     private readonly IApplicationPaths _appPaths;
     private readonly ILogger<ScriptInjector> _logger;
-    private const string ScriptTag = "<script src=\"Seasonals/Resources/seasonals.js\"></script>";
+    public const string ScriptTag = "<script src=\"/Seasonals/Resources/seasonals.js\" defer></script>";
-    private const string Marker = "</body>";
+    public const string Marker = "</body>";
 
     /// <summary>
     /// Initializes a new instance of the <see cref="ScriptInjector"/> class.
@@ -37,38 +42,44 @@ public class ScriptInjector
             var webPath = GetWebPath();
             if (string.IsNullOrEmpty(webPath))
             {
-                _logger.LogWarning("Could not find Jellyfin web path. Script injection skipped.");
+                _logger.LogWarning("Could not find Jellyfin web path. Script injection skipped. Attempting fallback.");
+                RegisterFileTransformation();
                 return;
             }
 
             var indexPath = Path.Combine(webPath, "index.html");
             if (!File.Exists(indexPath))
             {
-                _logger.LogWarning("index.html not found at {Path}. Script injection skipped.", indexPath);
+                _logger.LogWarning("index.html not found at {Path}. Script injection skipped. Attempting fallback.", indexPath);
+                RegisterFileTransformation();
                 return;
             }
 
             var content = File.ReadAllText(indexPath);
-            if (content.Contains(ScriptTag, StringComparison.Ordinal))
+            if (!content.Contains(ScriptTag))
             {
-                _logger.LogInformation("Seasonals script already injected.");
+                var index = content.IndexOf(Marker, StringComparison.OrdinalIgnoreCase);
-                return;
+                if (index != -1)
-            }
-
-            // Insert before the closing body tag
-            var newContent = content.Replace(Marker, $"{ScriptTag}\n{Marker}", StringComparison.Ordinal);
-            if (string.Equals(newContent, content, StringComparison.Ordinal))
                 {
-                _logger.LogWarning("Could not find closing body tag in index.html. Script injection skipped.");
+                    content = content.Insert(index, ScriptTag + Environment.NewLine);
-                return;
+                    File.WriteAllText(indexPath, content);
-            }
-
-            File.WriteAllText(indexPath, newContent);
                     _logger.LogInformation("Successfully injected Seasonals script into index.html.");
                 }
+                else
+                {
+                    _logger.LogWarning("Script already present in index.html. Or could not be injected.");
+                }
+            }
+        }
+        catch (UnauthorizedAccessException)
+        {
+            _logger.LogWarning("Unauthorized access when attempting to inject script into index.html. Automatic injection failed. Attempting fallback now...");
+            RegisterFileTransformation();
+        }
         catch (Exception ex)
         {
-            _logger.LogError(ex, "Error injecting Seasonals script.");
+            _logger.LogError(ex, "Error injecting Seasonals script. Attempting fallback.");
+            RegisterFileTransformation();
         }
     }
 
@@ -77,6 +88,8 @@ public class ScriptInjector
     /// </summary>
     public void Remove()
     {
+        UnregisterFileTransformation();
+
         try
         {
             var webPath = GetWebPath();
@@ -92,17 +105,18 @@ public class ScriptInjector
             }
 
             var content = File.ReadAllText(indexPath);
-            if (!content.Contains(ScriptTag, StringComparison.Ordinal))
+            if (content.Contains(ScriptTag))
             {
-                return;
+                content = content.Replace(ScriptTag + Environment.NewLine, "").Replace(ScriptTag, "");
-            }
+                File.WriteAllText(indexPath, content);
-
-            // Try to remove with newline first, then just the tag to ensure clean removal
-            var newContent = content.Replace($"{ScriptTag}\n", "", StringComparison.Ordinal)
-                                    .Replace(ScriptTag, "", StringComparison.Ordinal);
-            
-            File.WriteAllText(indexPath, newContent);
                 _logger.LogInformation("Successfully removed Seasonals script from index.html.");
+            } else {
+                _logger.LogInformation("Seasonals script tag not found in index.html. No removal necessary.");
+            }
+        }
+        catch (UnauthorizedAccessException)
+        {
+            _logger.LogWarning("Unauthorized access when attempting to remove script from index.html.");
         }
         catch (Exception ex)
         {
@@ -120,4 +134,74 @@ public class ScriptInjector
         var prop = _appPaths.GetType().GetProperty("WebPath", BindingFlags.Instance | BindingFlags.Public);
         return prop?.GetValue(_appPaths) as string;
     }
+
+    private void RegisterFileTransformation()
+    {
+        _logger.LogInformation("Seasonals Fallback. Registering file transformations.");
+        
+        List<JObject> payloads = new List<JObject>();
+
+        {
+            JObject payload = new JObject();
+            payload.Add("id", "ef1e863f-cbb0-4e47-9f23-f0cbb1826ad4"); 
+            payload.Add("fileNamePattern", "index.html");
+            payload.Add("callbackAssembly", GetType().Assembly.FullName);
+            payload.Add("callbackClass", typeof(TransformationPatches).FullName);
+            payload.Add("callbackMethod", nameof(TransformationPatches.IndexHtml));
+            
+            payloads.Add(payload);
+        }
+
+        Assembly? fileTransformationAssembly =
+            AssemblyLoadContext.All.SelectMany(x => x.Assemblies).FirstOrDefault(x =>
+                x.FullName?.Contains(".FileTransformation") ?? false);
+
+        if (fileTransformationAssembly != null)
+        {
+            Type? pluginInterfaceType = fileTransformationAssembly.GetType("Jellyfin.Plugin.FileTransformation.PluginInterface");
+
+            if (pluginInterfaceType != null)
+            {
+                foreach (JObject payload in payloads)
+                {
+                    pluginInterfaceType.GetMethod("RegisterTransformation")?.Invoke(null, new object?[] { payload });
+                }
+                _logger.LogInformation("File transformations registered successfully.");
+            }
+            else
+            {
+                _logger.LogWarning("FileTransformation plugin found but PluginInterface type missing.");
+            }
+        }
+        else
+        {
+                _logger.LogWarning("FileTransformation plugin assembly not found. Fallback injection skipped.");
+        }
+    }
+    
+    private void UnregisterFileTransformation()
+    {
+        try 
+        {
+            Assembly? fileTransformationAssembly =
+                AssemblyLoadContext.All.SelectMany(x => x.Assemblies).FirstOrDefault(x =>
+                    x.FullName?.Contains(".FileTransformation") ?? false);
+
+            if (fileTransformationAssembly != null)
+            {
+                Type? pluginInterfaceType = fileTransformationAssembly.GetType("Jellyfin.Plugin.FileTransformation.PluginInterface");
+
+                if (pluginInterfaceType != null)
+                {
+                    Guid id = Guid.Parse("ef1e863f-cbb0-4e47-9f23-f0cbb1826ad4");
+                    pluginInterfaceType.GetMethod("RemoveTransformation")?.Invoke(null, new object?[] { id });
+                    _logger.LogInformation("File transformation unregistered successfully.");
+                }
+            }
+        }
+        catch (Exception ex)
+        {
+            _logger.LogWarning(ex, "Error attempting to unregister file transformation. It might not have been registered.");
+        }
+    }
 }

Jellyfin.Plugin.Seasonals/SeasonalsPlugin.cs

@@ -13,9 +13,10 @@ namespace Jellyfin.Plugin.Seasonals;
 /// <summary>
 /// The main plugin. 
 /// </summary>
-public class Plugin : BasePlugin<PluginConfiguration>, IHasWebPages
+public class SeasonalsPlugin : BasePlugin<PluginConfiguration>, IHasWebPages
 {
     private readonly ScriptInjector _scriptInjector;
+    private readonly ILoggerFactory _loggerFactory;
 
     /// <summary>
     /// Initializes a new instance of the <see cref="Plugin"/> class.
@@ -23,13 +24,41 @@ public class Plugin : BasePlugin<PluginConfiguration>, IHasWebPages
     /// <param name="applicationPaths">Instance of the <see cref="IApplicationPaths"/> interface.</param>
     /// <param name="xmlSerializer">Instance of the <see cref="IXmlSerializer"/> interface.</param>
     /// <param name="loggerFactory">Instance of the <see cref="ILoggerFactory"/> interface.</param>
-    public Plugin(IApplicationPaths applicationPaths, IXmlSerializer xmlSerializer, ILoggerFactory loggerFactory)
+    public SeasonalsPlugin(IApplicationPaths applicationPaths, IXmlSerializer xmlSerializer, ILoggerFactory loggerFactory)
         : base(applicationPaths, xmlSerializer)
     {
         Instance = this;
+        _loggerFactory = loggerFactory;
         _scriptInjector = new ScriptInjector(applicationPaths, loggerFactory.CreateLogger<ScriptInjector>());
+        
+        if (Configuration.IsEnabled)
+        {
             _scriptInjector.Inject();
         }
+        else
+        {
+            _scriptInjector.Remove();
+        }
+    }
+
+    /// <inheritdoc />
+    public override void UpdateConfiguration(BasePluginConfiguration configuration)
+    {
+        var oldConfig = Configuration;
+        base.UpdateConfiguration(configuration);
+
+        if (Configuration.IsEnabled != oldConfig.IsEnabled)
+        {
+            if (Configuration.IsEnabled)
+            {
+                _scriptInjector.Inject();
+            }
+            else
+            {
+                _scriptInjector.Remove();
+            }
+        }
+    }
 
     /// <inheritdoc />
     public override string Name => "Seasonals";
@@ -40,18 +69,21 @@ public class Plugin : BasePlugin<PluginConfiguration>, IHasWebPages
     /// <summary>
     /// Gets the current plugin instance.
     /// </summary>
-    public static Plugin? Instance { get; private set; }
+    public static SeasonalsPlugin? Instance { get; private set; }
+
+
 
     /// <inheritdoc />
     public IEnumerable<PluginPageInfo> GetPages()
     {
-        return
+        return new[]
-        [
+        {
             new PluginPageInfo
             {
                 Name = Name,
+                EnableInMainMenu = true,
                 EmbeddedResourcePath = string.Format(CultureInfo.InvariantCulture, "{0}.Configuration.configPage.html", GetType().Namespace)
             }
-        ];
+        };
     }
 }

Jellyfin.Plugin.Seasonals/Web/autumn.css

@@ -1,12 +1,18 @@
 .autumn-container {
   display: block;
-  pointer-events: none;
+  position: fixed;
-  z-index: 0;
   overflow: hidden;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: 10;
 }
 
 .leaf {
   position: fixed;
+  z-index: 15;
   top: -10%;
   font-size: 1em;
   color: #fff;

Jellyfin.Plugin.Seasonals/Web/autumn.js

@@ -1,9 +1,11 @@
-const leaves = true; // enable/disable leaves
+const config = window.SeasonalsPluginConfig?.Autumn || {};
-const randomLeaves = true; // enable random leaves
+
-const randomLeavesMobile = false; // enable random leaves on mobile devices
+const leaves = config.EnableAutumn !== undefined ? config.EnableAutumn : true; // enable/disable leaves
-const enableDiffrentDuration = true; // enable different duration for the random leaves
+const randomLeaves = config.EnableRandomLeaves !== undefined ? config.EnableRandomLeaves : true; // enable random leaves
-const enableRotation = false; // enable/disable leaf rotation
+const randomLeavesMobile = config.EnableRandomLeavesMobile !== undefined ? config.EnableRandomLeavesMobile : false; // enable random leaves on mobile devices (Warning: High values may affect performance)
-const leafCount = 25; // count of random extra leaves
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random leaves
+const enableRotation = config.EnableRotation !== undefined ? config.EnableRotation : false; // enable/disable leaf rotation
+const leafCount = config.LeafCount || 25; // count of random extra leaves
 
 
 let msgPrinted = false; // flag to prevent multiple console messages
@@ -46,23 +48,23 @@ observer.observe(document.body, {
 
 
 const images = [
-  "Seasonals/Resources/autumn_images/acorn1.png",
+  "/Seasonals/Resources/autumn_images/acorn1.png",
-  "Seasonals/Resources/autumn_images/acorn2.png",
+  "/Seasonals/Resources/autumn_images/acorn2.png",
-  "Seasonals/Resources/autumn_images/leaf1.png",
+  "/Seasonals/Resources/autumn_images/leaf1.png",
-  "Seasonals/Resources/autumn_images/leaf2.png",
+  "/Seasonals/Resources/autumn_images/leaf2.png",
-  "Seasonals/Resources/autumn_images/leaf3.png",
+  "/Seasonals/Resources/autumn_images/leaf3.png",
-  "Seasonals/Resources/autumn_images/leaf4.png",
+  "/Seasonals/Resources/autumn_images/leaf4.png",
-  "Seasonals/Resources/autumn_images/leaf5.png",
+  "/Seasonals/Resources/autumn_images/leaf5.png",
-  "Seasonals/Resources/autumn_images/leaf6.png",
+  "/Seasonals/Resources/autumn_images/leaf6.png",
-  "Seasonals/Resources/autumn_images/leaf7.png",
+  "/Seasonals/Resources/autumn_images/leaf7.png",
-  "Seasonals/Resources/autumn_images/leaf8.png",
+  "/Seasonals/Resources/autumn_images/leaf8.png",
-  "Seasonals/Resources/autumn_images/leaf9.png",
+  "/Seasonals/Resources/autumn_images/leaf9.png",
-  "Seasonals/Resources/autumn_images/leaf10.png",
+  "/Seasonals/Resources/autumn_images/leaf10.png",
-  "Seasonals/Resources/autumn_images/leaf11.png",
+  "/Seasonals/Resources/autumn_images/leaf11.png",
-  "Seasonals/Resources/autumn_images/leaf12.png",
+  "/Seasonals/Resources/autumn_images/leaf12.png",
-  "Seasonals/Resources/autumn_images/leaf13.png",
+  "/Seasonals/Resources/autumn_images/leaf13.png",
-  "Seasonals/Resources/autumn_images/leaf14.png",
+  "/Seasonals/Resources/autumn_images/leaf14.png",
-  "Seasonals/Resources/autumn_images/leaf15.png",
+  "/Seasonals/Resources/autumn_images/leaf15.png",
 ];
 
 function addRandomLeaves(count) {

Jellyfin.Plugin.Seasonals/Web/christmas.css

@@ -1,12 +1,18 @@
 .christmas-container {
   display: block;
-  pointer-events: none;
+  position: fixed;
-  z-index: 0;
   overflow: hidden;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: 10;
 }
 
 .christmas {
   position: fixed;
+  z-index: 15;
   top: -10%;
   font-size: 1em;
   color: #fff;

Jellyfin.Plugin.Seasonals/Web/christmas.js

@@ -1,8 +1,10 @@
-const christmas = true; // enable/disable christmas
+const config = window.SeasonalsPluginConfig?.Christmas || {};
-const randomChristmas = true; // enable random Christmas
+
-const randomChristmasMobile = false; // enable random Christmas on mobile devices
+const christmas = config.EnableChristmas !== undefined ? config.EnableChristmas : true; // enable/disable christmas
-const enableDiffrentDuration = true; // enable different duration for the random Christmas symbols
+const randomChristmas = config.EnableRandomChristmas !== undefined ? config.EnableRandomChristmas : true; // enable random Christmas
-const christmasCount = 25; // count of random extra christmas
+const randomChristmasMobile = config.EnableRandomChristmasMobile !== undefined ? config.EnableRandomChristmasMobile : false; // enable random Christmas on mobile devices (Warning: High values may affect performance)
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random Christmas symbols
+const christmasCount = config.SymbolCount || 25; // count of random extra christmas
 
 
 let msgPrinted = false; // flag to prevent multiple console messages

Jellyfin.Plugin.Seasonals/Web/easter.css

@@ -1,12 +1,18 @@
 .easter-container {
     display: block;
-    pointer-events: none;
+  position: fixed;
-    z-index: 0;
   overflow: hidden;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: 10;
 }
 
 .hopping-rabbit {
     position: fixed;
+    z-index: 15;
     bottom: 10px;
     width: 70px;
     overflow: hidden;
@@ -23,6 +29,7 @@
 
 .easter {
     position: fixed;
+    z-index: 15;
     top: -10%;
     font-size: 1em;
     color: #fff;
@@ -40,6 +47,7 @@
 }
 
 .easter img {
+    z-index: 15;
     height: auto;
     width: 20px;
 }

Jellyfin.Plugin.Seasonals/Web/easter.js

@@ -1,14 +1,16 @@
-const easter = true; // enable/disable easter
+const config = window.SeasonalsPluginConfig?.Easter || {};
-const randomEaster = true; // enable random easter
-const randomEasterMobile = false; // enable random easter on mobile devices
-const enableDiffrentDuration = true; // enable different duration for the random easter
-const easterEggCount = 20; // count of random extra easter
 
-const bunny = true; // enable/disable hopping bunny
+const easter = config.EnableEaster !== undefined ? config.EnableEaster : true; // enable/disable easter
-const bunnyDuration = 12000; // duration of the bunny animation in ms
+const randomEaster = config.EnableRandomEaster !== undefined ? config.EnableRandomEaster : true; // enable random easter
-const hopHeight = 12; // height of the bunny hops in px
+const randomEasterMobile = config.EnableRandomEasterMobile !== undefined ? config.EnableRandomEasterMobile : false; // enable random easter on mobile devices (Warning: High values may affect performance)
-const minBunnyRestTime = 2000; // minimum time the bunny rests in ms
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random easter
-const maxBunnyRestTime = 5000; // maximum time the bunny rests in ms
+const easterEggCount = config.EggCount || 20; // count of random extra easter
+
+const bunny = config.EnableBunny !== undefined ? config.EnableBunny : true; // enable/disable hopping bunny
+const bunnyDuration = config.BunnyDuration || 12000; // duration of the bunny animation in ms
+const hopHeight = config.HopHeight || 12; // height of the bunny hops in px
+const minBunnyRestTime = config.MinBunnyRestTime || 2000; // minimum time the bunny rests in ms
+const maxBunnyRestTime = config.MaxBunnyRestTime || 5000; // maximum time the bunny rests in ms
 
 
 let msgPrinted = false; // flag to prevent multiple console messages
@@ -59,20 +61,20 @@ observer.observe(document.body, {
 
 
 const images = [
-    "Seasonals/Resources/easter_images/egg_1.png",
+    "/Seasonals/Resources/easter_images/egg_1.png",
-    "Seasonals/Resources/easter_images/egg_2.png",
+    "/Seasonals/Resources/easter_images/egg_2.png",
-    "Seasonals/Resources/easter_images/egg_3.png",
+    "/Seasonals/Resources/easter_images/egg_3.png",
-    "Seasonals/Resources/easter_images/egg_4.png",
+    "/Seasonals/Resources/easter_images/egg_4.png",
-    "Seasonals/Resources/easter_images/egg_5.png",
+    "/Seasonals/Resources/easter_images/egg_5.png",
-    "Seasonals/Resources/easter_images/egg_6.png",
+    "/Seasonals/Resources/easter_images/egg_6.png",
-    "Seasonals/Resources/easter_images/egg_7.png",
+    "/Seasonals/Resources/easter_images/egg_7.png",
-    "Seasonals/Resources/easter_images/egg_8.png",
+    "/Seasonals/Resources/easter_images/egg_8.png",
-    "Seasonals/Resources/easter_images/egg_9.png",
+    "/Seasonals/Resources/easter_images/egg_9.png",
-    "Seasonals/Resources/easter_images/egg_10.png",
+    "/Seasonals/Resources/easter_images/egg_10.png",
-    "Seasonals/Resources/easter_images/egg_11.png",
+    "/Seasonals/Resources/easter_images/egg_11.png",
-    "Seasonals/Resources/easter_images/egg_12.png",
+    "/Seasonals/Resources/easter_images/egg_12.png",
 ];
-const  rabbit = "Seasonals/Resources/easter_images/easter-bunny.png";
+const  rabbit = "/Seasonals/Resources/easter_images/easter-bunny.png";
 
 function addRandomEaster(count) {
     const easterContainer = document.querySelector('.easter-container'); // get the leave container

Jellyfin.Plugin.Seasonals/Web/fireworks.css

@@ -34,6 +34,7 @@
     transform: translateY(0);
     opacity: 1;
   }
+
   100% {
     transform: translateY(calc(var(--trailEndY) - var(--trailStartY)));
     opacity: 0;
@@ -46,6 +47,7 @@
     opacity: 1;
     transform: translate(0, 0);
   }
+
   100% {
     opacity: 0;
     transform: translate(var(--x), var(--y));

Jellyfin.Plugin.Seasonals/Web/fireworks.js

@@ -1,9 +1,11 @@
-const fireworks = true; // enable/disable fireworks
+const config = window.SeasonalsPluginConfig?.Fireworks || {};
-const scrollFireworks = true; // enable fireworks to scroll with page content
+
-const particlesPerFirework = 50; // count of particles per firework
+const fireworks = config.EnableFireworks !== undefined ? config.EnableFireworks : true; // enable/disable fireworks
-const minFireworks = 3; // minimum number of simultaneous fireworks
+const scrollFireworks = config.ScrollFireworks !== undefined ? config.ScrollFireworks : true; // enable fireworks to scroll with page content
-const maxFireworks = 6; // maximum number of simultaneous fireworks
+const particlesPerFirework = config.ParticleCount || 50; // count of particles per firework (Warning: High values may affect performance)
-const intervalOfFireworks = 3200; // interval for the fireworks in milliseconds
+const minFireworks = config.MinFireworks || 3; // minimum number of simultaneous fireworks
+const maxFireworks = config.MaxFireworks || 6; // maximum number of simultaneous fireworks
+const intervalOfFireworks = config.LaunchInterval || 3200; // interval for the fireworks in milliseconds
 
 // array of color palettes for the fireworks
 const colorPalettes = [
@@ -40,6 +42,11 @@ function toggleFirework() {
     }
   } else {
     fireworksContainer.style.display = 'block'; // show fireworks
+
+    if (scrollFireworks) {
+      fireworksContainer.style.height = `${document.documentElement.scrollHeight}px`;
+    }
+
     if (msgPrinted) {
       console.log('Fireworks visible');
       startFireworks();
@@ -115,8 +122,8 @@ function launchFirework() {
   let startY, endY;
   if (scrollFireworks) {
     // Y-position considers scrolling
-    startY = window.scrollY + window.innerHeight; // Bottom edge of the window plus the scroll offset
+    startY = window.scrollY + window.innerHeight;
-    endY = Math.random() * window.innerHeight * 0.5 + window.innerHeight * 0.2 + window.scrollY; // Area around the middle, but also with scrolling
+    endY = window.scrollY + (Math.random() * window.innerHeight * 0.5 + window.innerHeight * 0.2);
   } else {
     startY = window.innerHeight; // Bottom edge of the window
     endY = Math.random() * window.innerHeight * 0.5 + window.innerHeight * 0.2; // Area around the middle
@@ -133,14 +140,27 @@ function launchFirework() {
 
 // Start the firework routine 
 function startFireworks() {
-  const fireworkContainer = document.querySelector('.fireworks') || document.createElement("div");
+  let fireworkContainer = document.querySelector('.fireworks');
 
-  if (!document.querySelector('.fireworks')) {
+  if (!fireworkContainer) {
+    fireworkContainer = document.createElement("div");
     fireworkContainer.className = "fireworks";
     fireworkContainer.setAttribute("aria-hidden", "true");
     document.body.appendChild(fireworkContainer);
   }
 
+  fireworkContainer.style.position = scrollFireworks ? 'absolute' : 'fixed';
+
+  if (scrollFireworks) {
+    fireworkContainer.style.height = `${document.documentElement.scrollHeight}px`;
+    fireworkContainer.style.width = '100%';
+    fireworkContainer.style.top = '0';
+    fireworkContainer.style.left = '0';
+  } else {
+    fireworkContainer.style.height = '100%';
+    fireworkContainer.style.width = '100%';
+  }
+
   fireworksInterval = setInterval(() => {
     const randomCount = Math.floor(Math.random() * maxFireworks) + minFireworks;
     for (let i = 0; i < randomCount; i++) {

Jellyfin.Plugin.Seasonals/Web/halloween.css

@@ -1,14 +1,19 @@
 .halloween-container {
     display: block;
-    pointer-events: none;
+    position: fixed;
-    z-index: 0;
     overflow: hidden;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    pointer-events: none;
+    z-index: 10;
 }
 
 .halloween {
     position: fixed;
     bottom: -10%;
-    z-index: 0;
+    z-index: 15;
     -webkit-user-select: none;
     -moz-user-select: none;
     -ms-user-select: none;

Jellyfin.Plugin.Seasonals/Web/halloween.js

@@ -1,8 +1,10 @@
-const halloween = true; // enable/disable halloween
+const config = window.SeasonalsPluginConfig?.Halloween || {};
-const randomSymbols = true; // enable more random symbols
+
-const randomSymbolsMobile = false; // enable random symbols on mobile devices
+const halloween = config.EnableHalloween !== undefined ? config.EnableHalloween : true; // enable/disable halloween
-const enableDiffrentDuration = true; // enable different duration for the random halloween symbols
+const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable more random symbols
-const halloweenCount = 25; // count of random extra symbols
+const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile devices (Warning: High values may affect performance)
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random halloween symbols
+const halloweenCount = config.SymbolCount || 25; // count of random extra symbols
 
 let msgPrinted = false; // flag to prevent multiple console messages
 
@@ -44,9 +46,9 @@ observer.observe(document.body, {
 
 
 const images = [
-  "Seasonals/Resources/halloween_images/ghost_20x20.png",
+  "/Seasonals/Resources/halloween_images/ghost_20x20.png",
-  "Seasonals/Resources/halloween_images/bat_20x20.png",
+  "/Seasonals/Resources/halloween_images/bat_20x20.png",
-  "Seasonals/Resources/halloween_images/pumpkin_20x20.png",
+  "/Seasonals/Resources/halloween_images/pumpkin_20x20.png",
 ];
 
 function addRandomSymbols(count) {

Jellyfin.Plugin.Seasonals/Web/hearts.css

@@ -1,14 +1,19 @@
 .hearts-container {
     display: block;
-    pointer-events: none;
+    position: fixed;
-    z-index: 0;
     overflow: hidden;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
+    pointer-events: none;
+    z-index: 10;
 }
 
 .heart {
     position: fixed;
     bottom: -10%;
-    z-index: 0;
+    z-index: 15;
     -webkit-user-select: none;
     -moz-user-select: none;
     -ms-user-select: none;

Jellyfin.Plugin.Seasonals/Web/hearts.js

@@ -1,8 +1,10 @@
-const hearts = true; // enable/disable hearts
+const config = window.SeasonalsPluginConfig?.Hearts || {};
-const randomSymbols = true; // enable more random symbols
+
-const randomSymbolsMobile = false; // enable random symbols on mobile devices
+const hearts = config.EnableHearts !== undefined ? config.EnableHearts : true; // enable/disable hearts
-const enableDiffrentDuration = true; // enable different animation duration for random symbols
+const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable more random symbols
-const heartsCount = 25; // count of random extra symbols
+const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile devices (Warning: High values may affect performance)
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration for random symbols
+const heartsCount = config.SymbolCount || 25; // count of random extra symbols
 
 let msgPrinted = false; // flag to prevent multiple console messages
 

Jellyfin.Plugin.Seasonals/Web/santa.css

@@ -1,10 +1,13 @@
 .santa-container {
     position: fixed;
+    top: 0;
+    left: 0;
     width: 100%;
     height: 100vh;
     background: transparent;
     overflow: hidden;
     pointer-events: none;
+    z-index: 10;
 }
 
 #snowfallCanvas {
@@ -18,6 +21,7 @@
 
 .santa {
     position: fixed;
+    z-index: 12;
     width: 220px;
     height: auto;
     z-index: 1000;

Jellyfin.Plugin.Seasonals/Web/santa.js

@@ -1,13 +1,15 @@
-const santaIsFlying = true; // enable/disable santa
+const config = window.SeasonalsPluginConfig?.Santa || {};
-let snowflakesCount = 500; // count of snowflakes (recommended values: 300-600)
+
-const snowflakesCountMobile = 250; // count of snowflakes on mobile devices
+const santaIsFlying = config.EnableSanta !== undefined ? config.EnableSanta : true; // enable/disable santa
-const snowFallSpeed = 3; // speed of snowfall	(recommended values: 0-5)
+let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
-const santaSpeed = 10; // speed of santa in seconds (recommended values: 5000-15000)
+const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
-const santaSpeedMobile = 8; // speed of santa on mobile devices in seconds
+const snowFallSpeed = config.SnowFallSpeed || 3; // speed of snowfall	(recommended values: 0-5)
-const maxSantaRestTime = 8; // maximum time santa rests in seconds
+const santaSpeed = config.SantaSpeed || 10; // speed of santa in seconds (recommended values: 5-15)
-const minSantaRestTime = 3; // minimum time santa rests in seconds
+const santaSpeedMobile = config.SantaSpeedMobile || 8; // speed of santa on mobile devices in seconds
-const maxPresentFallSpeed = 5; // maximum speed of falling presents in seconds
+const maxSantaRestTime = config.MaxSantaRestTime || 8; // maximum time santa rests in seconds
-const minPresentFallSpeed = 2; // minimum speed of falling presents in seconds
+const minSantaRestTime = config.MinSantaRestTime || 3; // minimum time santa rests in seconds
+const maxPresentFallSpeed = config.MaxPresentFallSpeed || 5; // maximum speed of falling presents in seconds
+const minPresentFallSpeed = config.MinPresentFallSpeed || 2; // minimum speed of falling presents in seconds
 
 let msgPrinted = false; // flag to prevent multiple console messages
 let isMobile = false; // flag to detect mobile devices
@@ -58,6 +60,7 @@ observer.observe(document.body, {
     attributes: true    // observe changes to attributes (e.g. class changes)
 });
 
+let resizeObserver; // Observer for resize events
 
 function initializeCanvas() {
     if (document.getElementById('snowfallCanvas')) {
@@ -76,8 +79,12 @@ function initializeCanvas() {
     container.appendChild(canvas);
     ctx = canvas.getContext('2d');
 
+    // Initial resize
     resizeCanvas(container);
-    window.addEventListener('resize', () => resizeCanvas(container));
+
+    // Initialize ResizeObserver
+    resizeObserver = new ResizeObserver(() => resizeCanvas(container));
+    resizeObserver.observe(container);
 }
 
 function removeCanvas() {
@@ -94,15 +101,37 @@ function removeCanvas() {
             animationFrameIdSanta = null;
             console.log('Santa animation frame canceled');
         }
+
+        // Disconnect ResizeObserver
+        if (resizeObserver) {
+            resizeObserver.disconnect();
+            resizeObserver = null;
+        }
+
         console.log('Canvas removed');
     }
 }
 
 function resizeCanvas(container) {
     if (!canvas) return;
+
+    const oldWidth = canvas.width;
+    const oldHeight = canvas.height;
+
     const rect = container.getBoundingClientRect();
     canvas.width = rect.width;
     canvas.height = rect.height;
+
+    // Scale snowflakes positions if dimensions changed (to avoid clustering)
+    if (oldWidth > 0 && oldHeight > 0 && snowflakes.length > 0) {
+        const scaleX = canvas.width / oldWidth;
+        const scaleY = canvas.height / oldHeight;
+
+        snowflakes.forEach(flake => {
+            flake.x *= scaleX;
+            flake.y *= scaleY;
+        });
+    }
 }
 
 function createSnowflakes(container) {
@@ -152,18 +181,18 @@ function updateSnowflakes() {
 
 // credits: flaticon.com
 const presentImages = [
-    'Seasonals/Resources/santa_images/gift1.png',
+    '/Seasonals/Resources/santa_images/gift1.png',
-    'Seasonals/Resources/santa_images/gift2.png',
+    '/Seasonals/Resources/santa_images/gift2.png',
-    'Seasonals/Resources/santa_images/gift3.png',
+    '/Seasonals/Resources/santa_images/gift3.png',
-    'Seasonals/Resources/santa_images/gift4.png',
+    '/Seasonals/Resources/santa_images/gift4.png',
-    'Seasonals/Resources/santa_images/gift5.png',
+    '/Seasonals/Resources/santa_images/gift5.png',
-    'Seasonals/Resources/santa_images/gift6.png',
+    '/Seasonals/Resources/santa_images/gift6.png',
-    'Seasonals/Resources/santa_images/gift7.png',
+    '/Seasonals/Resources/santa_images/gift7.png',
-    'Seasonals/Resources/santa_images/gift8.png',
+    '/Seasonals/Resources/santa_images/gift8.png',
 ];
 
 // credits: https://www.animatedimages.org/img-animated-santa-claus-image-0420-85884.htm
-const santaImage = 'Seasonals/Resources/santa_images/santa.gif';
+const santaImage = '/Seasonals/Resources/santa_images/santa.gif';
 
 
 function createSantaElement() {

Jellyfin.Plugin.Seasonals/Web/seasonals.js

@@ -1,7 +1,8 @@
-// theme-configs.js
+/*
+ * Seasonals Plugin (Client Side Manager Logic)
+ */
 
-// theme configurations
+const ThemeConfigs = {
-const themeConfigs = {
     snowflakes: {
         css: '/Seasonals/Resources/snowflakes.css',
         js: '/Seasonals/Resources/snowflakes.js',
@@ -67,8 +68,221 @@ const themeConfigs = {
     },
 };
 
-// determine current theme based on the current month
+const SeasonalSettingsManager = {
-function determineCurrentTheme() {
+    initialized: false,
+    config: null,
+
+    init(config) {
+        if (this.initialized) return;
+        this.config = config;
+
+        // Only inject settings if enabled on server by admin
+        if (this.config && this.config.EnableClientSideToggle !== false) {
+            this.injectSettingsIcon();
+            this.initialized = true;
+            console.log("Seasonals: Client-Side Settings Manager initialized.");
+        }
+    },
+
+    getSetting(key, defaultValue) {
+        const value = localStorage.getItem(`seasonals-${key}`);
+        return value !== null ? value : defaultValue;
+    },
+
+    setSetting(key, value) {
+        localStorage.setItem(`seasonals-${key}`, value);
+    },
+
+    createIcon() {
+        const button = document.createElement('button');
+        button.type = 'button';
+        button.className = 'paper-icon-button-light headerButton seasonal-settings-button';
+        button.title = 'Seasonal Settings';
+        // button.innerHTML = '<span class="material-icons">ac_unit</span>';
+        button.innerHTML = '<img src="/Seasonals/Resources/assets/logo_SW.svg" draggable="false" style="width: 24px; height: 24px; vertical-align: middle; pointer-events: none;">';
+        button.style.verticalAlign = 'middle';
+
+        button.addEventListener('click', (e) => {
+            e.stopPropagation();
+            this.toggleSettingsPopup(button);
+        });
+
+        return button;
+    },
+
+    injectSettingsIcon() {
+        const observer = new MutationObserver((mutations, obs) => {
+            const headerRight = document.querySelector('.headerRight');
+            if (headerRight && !document.querySelector('.seasonal-settings-button')) {
+                const icon = this.createIcon();
+                headerRight.prepend(icon);
+            }
+        });
+
+        observer.observe(document.body, {
+            childList: true,
+            subtree: true
+        });
+    },
+
+    createPopup(anchorElement) {
+        const existing = document.querySelector('.seasonal-settings-popup');
+        if (existing) existing.remove();
+
+        const popup = document.createElement('div');
+        popup.className = 'seasonal-settings-popup dialog';
+
+        Object.assign(popup.style, {
+            position: 'fixed',
+            zIndex: '10000',
+            backgroundColor: '#202020',
+            padding: '1em',
+            borderRadius: '0.3em',
+            boxShadow: '0 0 20px rgba(0,0,0,0.5)',
+            minWidth: '200px',
+            color: '#fff',
+            maxWidth: '250px'
+        });
+
+        const rect = anchorElement.getBoundingClientRect();
+        
+        // Positioning logic
+        let rightPos = window.innerWidth - rect.right;
+        if (window.innerWidth < 450 || (window.innerWidth - rightPos) < 260) {
+            popup.style.right = '1rem';
+            popup.style.left = 'auto';
+        } else {
+            popup.style.right = `${rightPos}px`;
+            popup.style.left = 'auto';
+        }
+        popup.style.top = `${rect.bottom + 10}px`;
+
+        // Popup HTML
+        let html = `
+        <h3 style="margin-top:0; margin-bottom:1em; border-bottom:1px solid #444; padding-bottom:0.5em;">Seasonal Settings</h3>
+        
+        <div class="checkboxContainer checkboxContainer-withDescription" style="margin-bottom: 0.5em;">
+            <label class="emby-checkbox-label">
+                <input id="seasonal-enable-toggle" type="checkbox" is="emby-checkbox" class="emby-checkbox" />
+                <span class="checkboxLabel">Enable Seasonals</span>
+            </label>
+        </div>
+
+        <div class="selectContainer" style="margin-bottom: 0.5em;">
+            <label class="selectLabel" for="seasonal-theme-select" style="margin-bottom: 0.5em; display: block; color: inherit;">Force Theme</label>
+            <select id="seasonal-theme-select" class="emby-select" style="width: 100%; padding: 0.5em; background-color: #333; border: 1px solid #444; color: #fff; border-radius: 4px;">
+                <option value="auto">Server-Side</option>
+            </select>
+        </div>
+        `;
+
+        popup.innerHTML = html;
+
+        // Populate Select Options
+        const themeSelect = popup.querySelector('#seasonal-theme-select');
+        Object.keys(ThemeConfigs).forEach(key => {
+            if (key === 'none') return;
+            const option = document.createElement('option');
+            option.value = key;
+            option.textContent = key.charAt(0).toUpperCase() + key.slice(1);
+            themeSelect.appendChild(option);
+        });
+
+        // Set Initial Values
+        const enabledCheckbox = popup.querySelector('#seasonal-enable-toggle');
+        enabledCheckbox.checked = this.getSetting('enabled', 'true') === 'true';
+        themeSelect.value = this.getSetting('theme', 'auto');
+
+        // Event Listeners
+        enabledCheckbox.addEventListener('change', (e) => {
+            this.setSetting('enabled', e.target.checked);
+            location.reload();
+        });
+
+        themeSelect.addEventListener('change', (e) => {
+            this.setSetting('theme', e.target.value);
+            location.reload();
+        });
+
+        // Close on outside click
+        const closeHandler = (e) => {
+            if (!popup.contains(e.target) && e.target !== anchorElement && !anchorElement.contains(e.target)) {
+                popup.remove();
+                document.removeEventListener('click', closeHandler);
+            }
+        };
+        setTimeout(() => document.addEventListener('click', closeHandler), 0);
+
+        document.body.appendChild(popup);
+    },
+
+    toggleSettingsPopup(anchorElement) {
+        const existing = document.querySelector('.seasonal-settings-popup');
+        if (existing) {
+            existing.remove();
+        } else {
+            this.createPopup(anchorElement);
+        }
+    }
+};
+
+const SeasonalsManager = {
+    config: null,
+
+    async init() {
+        // Fetch Config
+        try {
+            const response = await fetch('/Seasonals/Config');
+            if (response.ok) {
+                this.config = await response.json();
+                window.SeasonalsPluginConfig = this.config;
+                console.log('Seasonals: Seasonals Config loaded:', this.config);
+            }
+        } catch (error) {
+            console.error('Seasonals: Error fetching Seasonals config:', error);
+        }
+
+        // Initialize Settings UI
+        SeasonalSettingsManager.init(this.config);
+
+        // User Preference Check
+        const isEnabled = SeasonalSettingsManager.getSetting('enabled', 'true') === 'true';
+        if (!isEnabled) {
+            console.log('Seasonals: Disabled by user preference.');
+            return;
+        }
+
+        // Determine Theme
+        const themeName = this.selectTheme();
+        console.log(`Seasonals: Selected theme: ${themeName}`);
+
+        if (!themeName || themeName === 'none') {
+            return;
+        }
+
+        // Apply Theme
+        this.applyTheme(themeName);
+    },
+
+    selectTheme() {
+        // Check local override
+        const forcedTheme = SeasonalSettingsManager.getSetting('theme', 'auto');
+        if (forcedTheme !== 'auto') {
+            console.log(`Seasonals: User forced theme: ${forcedTheme}`);
+            return forcedTheme;
+        }
+
+        const automate = this.config ? this.config.AutomateSeasonSelection : true;
+        const defaultTheme = this.config ? this.config.SelectedSeason : 'none';
+
+        if (!automate) {
+            return defaultTheme;
+        }
+
+        return this.determineCurrentThemeDate();
+    },
+
+    determineCurrentThemeDate() {
         const date = new Date();
         const month = date.getMonth();  // 0-11
         const day = date.getDate();     // 1-31
@@ -77,7 +291,7 @@ function determineCurrentTheme() {
     
         if (month === 1 && day >= 10 && day <= 18) return 'hearts'; // valentine's day february 10 - 18
     
-    if (month === 11 && day >= 22 && day <= 27) return 'santa'; // christmas december 22 - 27
+        if (month === 11 && day >= 22 && day <= 27) return 'santa'; // santa december 22 - 27
         // if (month === 11 && day >= 22 && day <= 27) return 'christmas'; // christmas december 22 - 27
     
         if (month === 11) return 'snowflakes'; // snowflakes december
@@ -96,111 +310,61 @@ function determineCurrentTheme() {
     
         if (month >= 8 && month <= 10) return 'autumn'; // autumn september, october, november
     
-    return 'none'; // Fallback (nothing)
+        return 'none'; // Fallback (no theme)
+    },
+
+    applyTheme(themeName) {
+        const theme = ThemeConfigs[themeName];
+        if (!theme) {
+            console.error(`Seasonals: Theme "${themeName}" not found.`);
+            return;
         }
 
-// load theme csss
+        this.updateThemeContainer(theme.containerClass);
-function loadThemeCSS(cssPath) {
-    if (!cssPath) return;
 
-    const link = document.createElement('link');
+        if (theme.css) this.loadResource('css', theme.css);
-    link.rel = 'stylesheet';
+        if (theme.js) this.loadResource('js', theme.js);
-    link.href = cssPath;
         
-    link.onerror = () => {
+        console.log(`Seasonals: Theme "${themeName}" applied.`);
-        console.error(`Failed to load CSS: ${cssPath}`);
+    },
-    };
 
-    document.body.appendChild(link);
+    updateThemeContainer(containerClass) {
-    console.log(`CSS file "${cssPath}" loaded.`);
-}
-
-// load theme js
-function loadThemeJS(jsPath) {
-    if (!jsPath) return;
-
-    const script = document.createElement('script');
-    script.src = jsPath;
-
-    script.onerror = () => {
-        console.error(`Failed to load JS: ${jsPath}`);
-    };
-
-    document.body.appendChild(script);
-    console.log(`JS file "${jsPath}" loaded.`);
-}
-
-// update theme container class name
-function updateThemeContainer(containerClass) {
-    // Create container if it doesn't exist
         let container = document.querySelector('.seasonals-container');
         if (!container) {
             container = document.createElement('div');
             container.className = 'seasonals-container';
             document.body.appendChild(container);
         }
-    
         container.className = `seasonals-container ${containerClass}`;
-    console.log(`Seasonals-Container class updated to "${containerClass}".`);
+    },
+
+    // helper to resolve paths for local testing vs production
+    resolvePath(path) {
+        if (window.location.protocol === 'file:' || window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1') {
+            return path.replace('/Seasonals/Resources/', './');
         }
+        return path;
+    },
 
-function removeSelf() {
+    loadResource(type, path) {
-    const script = document.currentScript;
+        if (!path) return;
-    if (script) script.parentNode.removeChild(script);
+        
-    console.log('External script removed:', script);
+        if (type === 'css') {
+            const link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.href = path;
+            // link.href = resolvePath(cssPath);
+            link.onerror = () => console.error(`Seasonals: Failed to load CSS: ${path}`);
+            document.body.appendChild(link);
+        } else if (type === 'js') {
+            const script = document.createElement('script');
+            script.src = path;
+            // script.src = resolvePath(jsPath);
+            script.defer = true;
+            script.onerror = () => console.error(`Seasonals: Failed to load JS: ${path}`);
+            document.body.appendChild(script);
         }
-
-// initialize theme
-async function initializeTheme() {
-    let automateThemeSelection = true;
-    let defaultTheme = 'none';
-
-    try {
-        const response = await fetch('/Seasonals/Config');
-        if (response.ok) {
-            const config = await response.json();
-            automateThemeSelection = config.automateSeasonSelection;
-            defaultTheme = config.selectedSeason;
-        } else {
-            console.error('Failed to fetch Seasonals config');
-        }
-    } catch (error) {
-        console.error('Error fetching Seasonals config:', error);
     }
+};
 
-    let currentTheme;
+SeasonalsManager.init();
-    if (!automateThemeSelection) {
-        currentTheme = defaultTheme;
-    } else {
-        currentTheme = determineCurrentTheme();
-    }
-
-    console.log(`Selected theme: ${currentTheme}`);
-
-    if (currentTheme === 'none') {
-        console.log('No theme selected.');
-        removeSelf();
-        return;
-    }
-
-    const theme = themeConfigs[currentTheme];
-    
-    if (!theme) {
-        console.error(`Theme "${currentTheme}" not found.`);
-        return;
-    }
-    updateThemeContainer(theme.containerClass);
-
-    if (theme.css) loadThemeCSS(theme.css);
-    if (theme.js) loadThemeJS(theme.js);
-
-    console.log(`Theme "${currentTheme}" loaded.`);
-
-    removeSelf();
-}
-
-
-//document.addEventListener('DOMContentLoaded', initializeTheme);
-document.addEventListener('DOMContentLoaded', () => {
-    initializeTheme();
-});

Jellyfin.Plugin.Seasonals/Web/snowfall.css

@@ -5,6 +5,9 @@
     background: transparent;
     overflow: hidden;
     pointer-events: none;
+    top: 0;
+    left: 0;
+    z-index: 10;
 }
 
 #snowfallCanvas {

Jellyfin.Plugin.Seasonals/Web/snowfall.js

@@ -1,7 +1,9 @@
-const snowfall = true; // enable/disable snowfall
+const config = window.SeasonalsPluginConfig?.Snowfall || {};
-let snowflakesCount = 500; // count of snowflakes (recommended values: 300-600)
+
-const snowflakesCountMobile = 250; // count of snowflakes on mobile devices
+const snowfall = config.EnableSnowfall !== undefined ? config.EnableSnowfall : true; // enable/disable snowfall
-const snowFallSpeed = 3; // speed of snowfall	(recommended values: 0-5)
+let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
+const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
+const snowFallSpeed = config.Speed || 3; // speed of snowfall	(recommended values: 0-5)
 
 let msgPrinted = false; // flag to prevent multiple console messages
 
@@ -53,6 +55,7 @@ observer.observe(document.body, {
   attributes: true    // observe changes to attributes (e.g. class changes)
 });
 
+let resizeObserver; // Observer for resize events
 
 function initializeCanvas() {
   if (document.getElementById('snowfallCanvas')) {
@@ -71,8 +74,12 @@ function initializeCanvas() {
   container.appendChild(canvas);
   ctx = canvas.getContext('2d');
 
+  // Initial resize
   resizeCanvas(container);
-  window.addEventListener('resize', () => resizeCanvas(container));
+
+  // Initialize ResizeObserver
+  resizeObserver = new ResizeObserver(() => resizeCanvas(container));
+  resizeObserver.observe(container);
 }
 
 function removeCanvas() {
@@ -84,15 +91,37 @@ function removeCanvas() {
       animationFrameId = null;
       console.log('Animation frame canceled');
     }
+
+    // Disconnect ResizeObserver
+    if (resizeObserver) {
+      resizeObserver.disconnect();
+      resizeObserver = null;
+    }
+
     console.log('Canvas removed');
   }
 }
 
 function resizeCanvas(container) {
   if (!canvas) return;
+
+  const oldWidth = canvas.width;
+  const oldHeight = canvas.height;
+
   const rect = container.getBoundingClientRect();
   canvas.width = rect.width;
   canvas.height = rect.height;
+
+  // Scale snowflakes positions if dimensions changed (to avoid clustering)
+  if (oldWidth > 0 && oldHeight > 0 && snowflakes.length > 0) {
+    const scaleX = canvas.width / oldWidth;
+    const scaleY = canvas.height / oldHeight;
+
+    snowflakes.forEach(flake => {
+      flake.x *= scaleX;
+      flake.y *= scaleY;
+    });
+  }
 }
 
 function createSnowflakes(container) {

Jellyfin.Plugin.Seasonals/Web/snowflakes.css

@@ -1,12 +1,18 @@
 .snowflakes {
   display: block;
-  pointer-events: none;
+  position: fixed;
-  z-index: 0;
   overflow: hidden;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+  z-index: 10;
 }
 
 .snowflake {
   position: fixed;
+  z-index: 15;
   top: -10%;
   font-size: 1em;
   color: #fff;

Jellyfin.Plugin.Seasonals/Web/snowflakes.js

@@ -1,9 +1,11 @@
-const snowflakes = true; // enable/disable snowflakes
+const config = window.SeasonalsPluginConfig?.Snowflakes || {};
-const randomSnowflakes = true; // enable random Snowflakes
+
-const randomSnowflakesMobile = false; // enable random Snowflakes on mobile devices
+const snowflakes = config.EnableSnowflakes !== undefined ? config.EnableSnowflakes : true; // enable/disable snowflakes
-const enableColoredSnowflakes = true; // enable colored snowflakes on mobile devices
+const randomSnowflakes = config.EnableRandomSnowflakes !== undefined ? config.EnableRandomSnowflakes : true; // enable random Snowflakes
-const enableDiffrentDuration = true; // enable different animation duration for random symbols
+const randomSnowflakesMobile = config.EnableRandomSnowflakesMobile !== undefined ? config.EnableRandomSnowflakesMobile : false; // enable random Snowflakes on mobile devices
-const snowflakeCount = 25; // count of random extra snowflakes
+const enableColoredSnowflakes = config.EnableColoredSnowflakes !== undefined ? config.EnableColoredSnowflakes : true; // enable colored snowflakes
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration
+const snowflakeCount = config.SnowflakeCount || 25; // count of random extra snowflakes
 
 
 let msgPrinted = false; // flag to prevent multiple console messages

Jellyfin.Plugin.Seasonals/Web/snowstorm.css

@@ -1,7 +1,20 @@
-.snowflake {
+.snowstorm-container {
     position: fixed;
-    background-color: rgba(255, 255, 255, 0.8);
+    width: 100%;
-    border-radius: 50%;
+    height: 100vh;
+    background: transparent;
+    overflow: hidden;
+    pointer-events: none;
+    top: 0;
+    left: 0;
+    z-index: 10;
+}
+
+#snowfallCanvas {
+    position: absolute;
+    top: 0;
+    left: 0;
+    width: 100%;
+    height: 100%;
     pointer-events: none;
-    opacity: 0.7;
 }

Jellyfin.Plugin.Seasonals/Web/snowstorm.js

@@ -1,9 +1,11 @@
-const snowstorm = true; // enable/disable snowstorm
+const config = window.SeasonalsPluginConfig?.Snowstorm || {};
-let snowflakesCount = 500; // count of snowflakes (recommended values: 300-600)
+
-const snowflakesCountMobile = 250; // count of snowflakes on mobile devices
+const snowstorm = config.enableSnowstorm !== undefined ? config.EnableSnowstorm : true; // enable/disable snowstorm
-const snowFallSpeed = 6; // speed of snowfall	(recommended values: 4-8)
+let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
-const horizontalWind = 4; // horizontal wind speed (recommended value: 4)
+const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
-const verticalVariation = 2; // vertical variation (recommended value: 2)
+const snowFallSpeed = config.Speed || 6; // speed of snowfall	(recommended values: 4-8)
+const horizontalWind = config.HorizontalWind || 4; // horizontal wind speed (recommended value: 4)
+const verticalVariation = config.VerticalVariation || 2; // vertical variation (recommended value: 2)
 
 let msgPrinted = false; // flag to prevent multiple console messages
 
@@ -55,6 +57,7 @@ observer.observe(document.body, {
   attributes: true    // observe changes to attributes (e.g. class changes)
 });
 
+let resizeObserver; // Observer for resize events
 
 function initializeCanvas() {
   if (document.getElementById('snowfallCanvas')) {
@@ -64,7 +67,7 @@ function initializeCanvas() {
 
   const container = document.querySelector('.snowstorm-container');
   if (!container) {
-    console.error('Error: No element with class "snowfall-container" found.');
+    console.error('Error: No element with class "snowstorm-container" found.');
     return;
   }
 
@@ -73,8 +76,12 @@ function initializeCanvas() {
   container.appendChild(canvas);
   ctx = canvas.getContext('2d');
 
+  // Initial resize
   resizeCanvas(container);
-  window.addEventListener('resize', () => resizeCanvas(container));
+
+  // Initialize ResizeObserver
+  resizeObserver = new ResizeObserver(() => resizeCanvas(container));
+  resizeObserver.observe(container);
 }
 
 function removeCanvas() {
@@ -86,15 +93,37 @@ function removeCanvas() {
       animationFrameId = null;
       console.log('Animation frame canceled');
     }
+
+    // Disconnect ResizeObserver
+    if (resizeObserver) {
+      resizeObserver.disconnect();
+      resizeObserver = null;
+    }
+
     console.log('Canvas removed');
   }
 }
 
 function resizeCanvas(container) {
   if (!canvas) return;
+
+  const oldWidth = canvas.width;
+  const oldHeight = canvas.height;
+
   const rect = container.getBoundingClientRect();
   canvas.width = rect.width;
   canvas.height = rect.height;
+
+  // Scale snowflakes positions if dimensions changed (to avoid clustering)
+  if (oldWidth > 0 && oldHeight > 0 && snowflakes.length > 0) {
+    const scaleX = canvas.width / oldWidth;
+    const scaleY = canvas.height / oldHeight;
+
+    snowflakes.forEach(flake => {
+      flake.x *= scaleX;
+      flake.y *= scaleY;
+    });
+  }
 }
 
 function createSnowflakes(container) {

Jellyfin.Plugin.Seasonals/Web/test-site-new.html

@@ -0,0 +1,79 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Seasonals Test Display</title>
+    <link rel="stylesheet" href="snowfall.css">
+    <style>
+        body {
+            background-color: black;
+            color: white;
+            margin: 0;
+            font-family: sans-serif;
+        }
+
+        /* Mock Jellyfin Header */
+        .skinHeader {
+            background-color: #101010;
+            height: 60px;
+            display: flex;
+            align-items: center;
+            padding: 0 1em;
+            border-bottom: 1px solid #333;
+        }
+
+        .headerRight {
+            margin-left: auto;
+            display: flex;
+            align-items: center;
+        }
+
+        .paper-icon-button-light {
+            background: none;
+            border: none;
+            color: white;
+            cursor: pointer;
+            padding: 10px;
+        }
+
+        .material-icons {
+            font-family: 'Material Icons';
+            /* Placeholder if not loaded */
+            font-weight: normal;
+            font-style: normal;
+            font-size: 24px;
+            display: inline-block;
+            line-height: 1;
+            text-transform: none;
+            letter-spacing: normal;
+            word-wrap: normal;
+            white-space: nowrap;
+            direction: ltr;
+        }
+    </style>
+    <!-- Load Material Icons for the snowflake -->
+    <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
+</head>
+
+<body>
+    <!-- Mock Header Structure -->
+    <div class="skinHeader">
+        <div class="skinHeader-content">
+            <span>Jellyfin Mock Header</span>
+        </div>
+        <div class="headerRight">
+            <button class="paper-icon-button-light">
+                <span class="material-icons">person</span>
+            </button>
+        </div>
+    </div>
+
+    <div class="seasonals-container"></div>
+
+    <!-- Load the main script -->
+    <script src="seasonals.js"></script>
+</body>
+
+</html>

Jellyfin.Plugin.Seasonals/bin/Release/net9.0/Jellyfin.Plugin.Seasonals.deps.json

@@ -1,624 +0,0 @@
-{
-  "runtimeTarget": {
-    "name": ".NETCoreApp,Version=v9.0",
-    "signature": ""
-  },
-  "compilationOptions": {},
-  "targets": {
-    ".NETCoreApp,Version=v9.0": {
-      "Jellyfin.Plugin.Seasonals/1.0.0.0": {
-        "dependencies": {
-          "Jellyfin.Controller": "10.11.0",
-          "Jellyfin.Model": "10.11.0"
-        },
-        "runtime": {
-          "Jellyfin.Plugin.Seasonals.dll": {}
-        }
-      },
-      "BitFaster.Caching/2.5.4": {
-        "runtime": {
-          "lib/net6.0/BitFaster.Caching.dll": {
-            "assemblyVersion": "2.5.4.0",
-            "fileVersion": "2.5.4.0"
-          }
-        }
-      },
-      "Diacritics/4.0.17": {
-        "runtime": {
-          "lib/net9.0/Diacritics.dll": {
-            "assemblyVersion": "4.0.17.0",
-            "fileVersion": "4.0.17.0"
-          }
-        }
-      },
-      "ICU4N/60.1.0-alpha.356": {
-        "dependencies": {
-          "J2N": "2.0.0",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10"
-        },
-        "runtime": {
-          "lib/netstandard2.0/ICU4N.dll": {
-            "assemblyVersion": "60.0.0.0",
-            "fileVersion": "60.1.0.0"
-          }
-        }
-      },
-      "ICU4N.Transliterator/60.1.0-alpha.356": {
-        "dependencies": {
-          "ICU4N": "60.1.0-alpha.356"
-        },
-        "runtime": {
-          "lib/netstandard2.0/ICU4N.Transliterator.dll": {
-            "assemblyVersion": "60.0.0.0",
-            "fileVersion": "60.1.0.0"
-          }
-        }
-      },
-      "J2N/2.0.0": {
-        "runtime": {
-          "lib/net6.0/J2N.dll": {
-            "assemblyVersion": "2.0.0.0",
-            "fileVersion": "2.0.0.0"
-          }
-        }
-      },
-      "Jellyfin.Common/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Model": "10.11.0",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Common.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Controller/10.11.0": {
-        "dependencies": {
-          "BitFaster.Caching": "2.5.4",
-          "Jellyfin.Common": "10.11.0",
-          "Jellyfin.MediaEncoding.Keyframes": "10.11.0",
-          "Jellyfin.Model": "10.11.0",
-          "Jellyfin.Naming": "10.11.0",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Configuration.Binder": "9.0.10",
-          "System.Threading.Tasks.Dataflow": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Controller.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Data/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Database.Implementations": "10.11.0",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Data.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Database.Implementations/10.11.0": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore.Relational": "9.0.10",
-          "Polly": "8.6.4"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Database.Implementations.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Extensions/10.11.0": {
-        "dependencies": {
-          "Diacritics": "4.0.17",
-          "ICU4N.Transliterator": "60.1.0-alpha.356"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Extensions.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.MediaEncoding.Keyframes/10.11.0": {
-        "dependencies": {
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "NEbml": "1.1.0.5"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.MediaEncoding.Keyframes.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Model/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Data": "10.11.0",
-          "Jellyfin.Extensions": "10.11.0",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "System.Globalization": "4.3.0",
-          "System.Text.Json": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Model.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Naming/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Common": "10.11.0",
-          "Jellyfin.Model": "10.11.0"
-        },
-        "runtime": {
-          "lib/net9.0/Emby.Naming.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore/9.0.10": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore.Abstractions": "9.0.10",
-          "Microsoft.EntityFrameworkCore.Analyzers": "9.0.10",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore.Abstractions/9.0.10": {
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.Abstractions.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore.Analyzers/9.0.10": {},
-      "Microsoft.EntityFrameworkCore.Relational/9.0.10": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore": "9.0.10",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.Relational.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.Extensions.Caching.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Caching.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Caching.Memory/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Caching.Abstractions": "9.0.10",
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Options": "9.0.10",
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Caching.Memory.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Configuration.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Configuration.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Configuration.Binder/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Configuration.Binder.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.DependencyInjection/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.DependencyInjection.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.DependencyInjection.Abstractions/9.0.10": {
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.DependencyInjection.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Logging/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection": "9.0.10",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Options": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Logging.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Logging.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Logging.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Options/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Options.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Primitives/9.0.10": {
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Primitives.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.NETCore.Platforms/1.1.0": {},
-      "Microsoft.NETCore.Targets/1.1.0": {},
-      "NEbml/1.1.0.5": {
-        "runtime": {
-          "lib/netstandard2.0/NEbml.Core.dll": {
-            "assemblyVersion": "1.1.0.5",
-            "fileVersion": "1.1.0.5"
-          }
-        }
-      },
-      "Polly/8.6.4": {
-        "dependencies": {
-          "Polly.Core": "8.6.4"
-        },
-        "runtime": {
-          "lib/net6.0/Polly.dll": {
-            "assemblyVersion": "8.0.0.0",
-            "fileVersion": "8.6.4.5033"
-          }
-        }
-      },
-      "Polly.Core/8.6.4": {
-        "runtime": {
-          "lib/net8.0/Polly.Core.dll": {
-            "assemblyVersion": "8.0.0.0",
-            "fileVersion": "8.6.4.5033"
-          }
-        }
-      },
-      "System.Globalization/4.3.0": {
-        "dependencies": {
-          "Microsoft.NETCore.Platforms": "1.1.0",
-          "Microsoft.NETCore.Targets": "1.1.0",
-          "System.Runtime": "4.3.0"
-        }
-      },
-      "System.Runtime/4.3.0": {
-        "dependencies": {
-          "Microsoft.NETCore.Platforms": "1.1.0",
-          "Microsoft.NETCore.Targets": "1.1.0"
-        }
-      },
-      "System.Text.Json/9.0.10": {},
-      "System.Threading.Tasks.Dataflow/9.0.10": {}
-    }
-  },
-  "libraries": {
-    "Jellyfin.Plugin.Seasonals/1.0.0.0": {
-      "type": "project",
-      "serviceable": false,
-      "sha512": ""
-    },
-    "BitFaster.Caching/2.5.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-1QroTY1PVCZOSG9FnkkCrmCKk/+bZCgI/YXq376HnYwUDJ4Ho0EaV4YaA/5v5WYLnwIwIO7RZkdWbg9pxIpueQ==",
-      "path": "bitfaster.caching/2.5.4",
-      "hashPath": "bitfaster.caching.2.5.4.nupkg.sha512"
-    },
-    "Diacritics/4.0.17": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-FmMvVQRsfon+x5P+dxz4mvV8wt45xr25EAOCkuo/Cjtc7lVYV5cZUSsNXwmKQpwO+TokIHpzxb8ENpqrm4yBlQ==",
-      "path": "diacritics/4.0.17",
-      "hashPath": "diacritics.4.0.17.nupkg.sha512"
-    },
-    "ICU4N/60.1.0-alpha.356": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-YMZtDnjcqWzziOKiE7w6Ma7Rl5vuFDxzOsUlHh1QyfghbNEIZQOLRs9MMfwCWAjX6n9UitrF6vLXy55Z5q+4Fg==",
-      "path": "icu4n/60.1.0-alpha.356",
-      "hashPath": "icu4n.60.1.0-alpha.356.nupkg.sha512"
-    },
-    "ICU4N.Transliterator/60.1.0-alpha.356": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-lFOSO6bbEtB6HkWMNDJAq+rFwVyi9g6xVc5O/2xHa6iZnV7wLVDqCbaQ4W4vIeBSQZAafqhxciaEkmAvSdzlCg==",
-      "path": "icu4n.transliterator/60.1.0-alpha.356",
-      "hashPath": "icu4n.transliterator.60.1.0-alpha.356.nupkg.sha512"
-    },
-    "J2N/2.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-M5bwDajAARZiyqupU+rHQJnsVLxNBOHJ8vKYHd8LcLIb1FgLfzzcJvc31Qo5Xz/GEHFjDF9ScjKL/ks/zRTXuA==",
-      "path": "j2n/2.0.0",
-      "hashPath": "j2n.2.0.0.nupkg.sha512"
-    },
-    "Jellyfin.Common/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-TitN7+qWFt2l0V5b+KTRt7ABDCvfZdvSC6qBG1uHS18Y80xrbrSCJ9O6BH/of310h6a4lxKlQjUtTPHCzeG2AA==",
-      "path": "jellyfin.common/10.11.0",
-      "hashPath": "jellyfin.common.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Controller/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-WV+PQy9AHdZLvYqUsNq6ZyQoxaiaEWLz0EwZGOiu8xSrepQLFope2U1VFHVCNbARwesg7s/B+9uB03eXDsQw9w==",
-      "path": "jellyfin.controller/10.11.0",
-      "hashPath": "jellyfin.controller.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Data/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-YEz7/85b98Rj14IJJIVqmzJsi69LDOKo4Ox+VHbh1vj3tkWomSPayzvG3kyU8I0yFMrd6+Ta55C20kZ2XC7vQg==",
-      "path": "jellyfin.data/10.11.0",
-      "hashPath": "jellyfin.data.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Database.Implementations/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-oLblVZzqF9zuLMdfqp8pbusSVQq6b40/RcHjGF1hxYozVNEi+UhiDX8aJipYBOrh33FFAofoQq468BvZixpPcw==",
-      "path": "jellyfin.database.implementations/10.11.0",
-      "hashPath": "jellyfin.database.implementations.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Extensions/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-1ufj+Rm0Bn6C990i2wwiT5UHPZfD65GOtJK6NcDU//DDMbuoGX1LQZxuCx+rhhRg1XdHPWzYASARYyNlFQa6cg==",
-      "path": "jellyfin.extensions/10.11.0",
-      "hashPath": "jellyfin.extensions.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.MediaEncoding.Keyframes/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-/OBcg4Qj825elOGNj5bNRfABKzfAf4qNQj0/d/DwhG/+V/wsKuxS0Pc/xOEagVVjXOnqGPZz/+k8D4UvnvMoHw==",
-      "path": "jellyfin.mediaencoding.keyframes/10.11.0",
-      "hashPath": "jellyfin.mediaencoding.keyframes.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Model/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-h+61RSXn4sk8fS6Zx9RkDyVnI5VnNbrsR2p8WcvybtNSW2pgU2uZ9pwEv2awD3ifX69weqYpQLMh91f6aidW2A==",
-      "path": "jellyfin.model/10.11.0",
-      "hashPath": "jellyfin.model.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Naming/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-2++xSbhdFSb1J3XySjC6UU+uII6OdKc0DfkYx/E1oN7mSjoftyZR8eU045kVWBwsAxr+UcMI6t2DYfES2tJkRA==",
-      "path": "jellyfin.naming/10.11.0",
-      "hashPath": "jellyfin.naming.10.11.0.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-WjjxVyOTVs85V7SUe+lZjtGOEeVzF4RO8amrqL4adgbyThNq7vGCFzPw8buZj44gHeQYD5V/uZ/6XuqG9Jq+kA==",
-      "path": "microsoft.entityframeworkcore/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-I3TWAs5Lbzmzu8S0T6qXhzBiO3CznYLrfE59W0npkqNHfWGH8CgA66LrHMWxWOXVTD4145QwYqiWNCdLwpJ1Ew==",
-      "path": "microsoft.entityframeworkcore.abstractions/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Analyzers/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-mXNl0Gg3l3zGrClLCHepB+b7rYVuFfB9qQJwya0dUSHFuR1T0jMD8KxuNVyhQSfoWIepanhzjcG8TUNGXOcU0Q==",
-      "path": "microsoft.entityframeworkcore.analyzers/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.analyzers.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Relational/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-IJNrG5vdmFUvHR8FLLFg9AWpuE8qW1DTEN+fNLGbNTu6cnpZzzqU6+aknAGtTSAEVWosJ3BZ3TOO9wpifUvv3A==",
-      "path": "microsoft.entityframeworkcore.relational/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.relational.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Caching.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-cL6iTxgJ4u5zP3eFOdBiDAtmE/B2WKTRhyJfEne7n6qvHpsMwwIDxljs210mWSO1ucBy7lR1Lo7/7kjeZeLcqQ==",
-      "path": "microsoft.extensions.caching.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.caching.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Caching.Memory/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-2iuzwIoCoqZJfH2VLk1xvlQS4PQDEuhj4dWiGb+Qpt1vHFHyffp497cTO6ucsV54W/h4JmM1vzDBv8pVAFazZg==",
-      "path": "microsoft.extensions.caching.memory/9.0.10",
-      "hashPath": "microsoft.extensions.caching.memory.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Configuration.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-ad3JxmFj0uxuFa1CT6oxTCC1lQ0xeRuOvzBRFT/I/ofIXVOnNsH/v2GZkAJWhlpZqKUvSexQZzp3EEAB2CdtJg==",
-      "path": "microsoft.extensions.configuration.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.configuration.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Configuration.Binder/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-D6Kng+9I+w1SQPxJybc6wzw9nnnyUQPutycjtI0svv1RHaWOpUk9PPlwIRfhhoQZ3yihejkEI2wNv/7VnVtkGA==",
-      "path": "microsoft.extensions.configuration.binder/9.0.10",
-      "hashPath": "microsoft.extensions.configuration.binder.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.DependencyInjection/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-iEtXCkNd5XhjNJAOb/wO4IhDRdLIE2CsPxZggZQWJ/q2+sa8dmEPC393nnsiqdH8/4KV8Xn25IzgKPR1UEQ0og==",
-      "path": "microsoft.extensions.dependencyinjection/9.0.10",
-      "hashPath": "microsoft.extensions.dependencyinjection.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.DependencyInjection.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-r9waLiOPe9ZF1PvzUT+RDoHvpMmY8MW+lb4lqjYGObwKpnyPMLI3odVvlmshwuZcdoHynsGWOrCPA0hxZ63lIA==",
-      "path": "microsoft.extensions.dependencyinjection.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.dependencyinjection.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Logging/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-UBXHqE9vyptVhaFnT1R7YJKCve7TqVI10yjjUZBNGMlW2lZ4c031Slt9hxsOzWCzlpPxxIFyf1Yk4a6Iubxx7w==",
-      "path": "microsoft.extensions.logging/9.0.10",
-      "hashPath": "microsoft.extensions.logging.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Logging.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-MFUPv/nN1rAQ19w43smm6bbf0JDYN/1HEPHoiMYY50pvDMFpglzWAuoTavByDmZq7UuhjaxwrET3joU69ZHoHQ==",
-      "path": "microsoft.extensions.logging.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.logging.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Options/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-zMNABt8eBv0B0XrWjFy9nZNgddavaOeq3ZdaD5IlHhRH65MrU7HM+Hd8GjWE3e2VDGFPZFfSAc6XVXC17f9fOA==",
-      "path": "microsoft.extensions.options/9.0.10",
-      "hashPath": "microsoft.extensions.options.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Primitives/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-3pl8D1O5ZwMpDkZAT2uXrhQ6NipkwEgDLMFuURiHTf72TvkoMP61QYH3Vk1yrzVHnHBdNZk3cQACz8Zc7YGNhQ==",
-      "path": "microsoft.extensions.primitives/9.0.10",
-      "hashPath": "microsoft.extensions.primitives.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.NETCore.Platforms/1.1.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-kz0PEW2lhqygehI/d6XsPCQzD7ff7gUJaVGPVETX611eadGsA3A877GdSlU0LRVMCTH/+P3o2iDTak+S08V2+A==",
-      "path": "microsoft.netcore.platforms/1.1.0",
-      "hashPath": "microsoft.netcore.platforms.1.1.0.nupkg.sha512"
-    },
-    "Microsoft.NETCore.Targets/1.1.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-aOZA3BWfz9RXjpzt0sRJJMjAscAUm3Hoa4UWAfceV9UTYxgwZ1lZt5nO2myFf+/jetYQo4uTP7zS8sJY67BBxg==",
-      "path": "microsoft.netcore.targets/1.1.0",
-      "hashPath": "microsoft.netcore.targets.1.1.0.nupkg.sha512"
-    },
-    "NEbml/1.1.0.5": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-svtqDc+hue9kbnqNN2KkK4om/hDrc7K127cNb5FIYfgKgzo+JNDPXNLp8NioCchHhBO3lxWd4Cp/iiZZ3aoUqg==",
-      "path": "nebml/1.1.0.5",
-      "hashPath": "nebml.1.1.0.5.nupkg.sha512"
-    },
-    "Polly/8.6.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-uuBsDoBw0oYrMe3uTWRjkT2sIkKh+ZZnnDrLb4Z+QANfeA4+7FJacx6E8CY5GAxXRoSgFrvUADEAQ7DPF6fGiw==",
-      "path": "polly/8.6.4",
-      "hashPath": "polly.8.6.4.nupkg.sha512"
-    },
-    "Polly.Core/8.6.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-4AWqYnQ2TME0E+Mzovt1Uu+VyvpR84ymUldMcPw7Mbj799Phaag14CKrMtlJGx5jsvYP+S3oR1QmysgmXoD5cw==",
-      "path": "polly.core/8.6.4",
-      "hashPath": "polly.core.8.6.4.nupkg.sha512"
-    },
-    "System.Globalization/4.3.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-kYdVd2f2PAdFGblzFswE4hkNANJBKRmsfa2X5LG2AcWE1c7/4t0pYae1L8vfZ5xvE2nK/R9JprtToA61OSHWIg==",
-      "path": "system.globalization/4.3.0",
-      "hashPath": "system.globalization.4.3.0.nupkg.sha512"
-    },
-    "System.Runtime/4.3.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-JufQi0vPQ0xGnAczR13AUFglDyVYt4Kqnz1AZaiKZ5+GICq0/1MH/mO/eAJHt/mHW1zjKBJd7kV26SrxddAhiw==",
-      "path": "system.runtime/4.3.0",
-      "hashPath": "system.runtime.4.3.0.nupkg.sha512"
-    },
-    "System.Text.Json/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-XM02ZBnzxk7Ti6l9YRy8Bp639wANqJzJzw4W4VYiCh+HXY9hBOWkGB4k89OLP/s/RxgM02P4a/mWcJTgFiLf1Q==",
-      "path": "system.text.json/9.0.10",
-      "hashPath": "system.text.json.9.0.10.nupkg.sha512"
-    },
-    "System.Threading.Tasks.Dataflow/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-k1o6v6V3+4mznSnPnO0FBaRjiAPL1ouKPfPQH7hO9Z2SwJHt8E45F4wX5yQh1aeja1JHPYEungQedXibng654Q==",
-      "path": "system.threading.tasks.dataflow/9.0.10",
-      "hashPath": "system.threading.tasks.dataflow.9.0.10.nupkg.sha512"
-    }
-  }
-}

README.md

@@ -2,7 +2,9 @@
 
 Jellyfin Seasonals is a plugin that adds seasonal themes to your Jellyfin web interface. Depending on the configuration, it automatically selects a theme based on the current date or allows you to manually set a default theme.
 
-This plugin is based on my manual mod (see the `manual` branch), which builds up on the awesome work of [BobHasNoSoul-jellyfin-mods](https://github.com/BobHasNoSoul/jellyfin-mods).
+This plugin is based on my manual mod (see the [legacy branch](https://github.com/CodeDevMLH/Jellyfin-Seasonals/tree/legacy)), which builds up on the awesome work of [BobHasNoSoul-jellyfin-mods](https://github.com/BobHasNoSoul/jellyfin-mods).
+
+![logo](https://raw.githubusercontent.com/CodeDevMLH/Jellyfin-Seasonals/refs/heads/main/logo.png)
 
 ---
 
@@ -11,15 +13,17 @@ This plugin is based on my manual mod (see the `manual` branch), which builds up
   - [Table of Contents](#table-of-contents)
   - [Features](#features)
   - [Overview](#overview)
+  - [Ideas for additional seasonals](#ideas-for-additional-seasonals)
   - [Installation](#installation)
-  - [Usage](#usage)
+  - [Client Compatibility](#client-compatibility)
-  - [Build Process](#build-process)
+  - [Configuration](#configuration)
-  - [Contributing](#contributing)
+  - [Automatic Theme Selection](#automatic-theme-selection)
-  - [Legacy Manual Installation](#legacy-manual-installation)
-    - [Installation](#installation-1)
   - [Theme Settings](#theme-settings)
-    - [Additional Directory: Separate Single Seasonals](#additional-directory-separate-single-seasonals)
+  - [Build the plugin by yourself](#build-the-plugin-by-yourself)
   - [Troubleshooting](#troubleshooting)
+    - [Effects Not Showing](#effects-not-showing)
+    - [Docker Permission Issues](#docker-permission-issues)
+  - [Contributing](#contributing)
 
 ---
 
@@ -27,71 +31,152 @@ This plugin is based on my manual mod (see the `manual` branch), which builds up
 
 - **Automatic Theme Selection**: Dynamically updates the theme based on the date (e.g., snowflakes in December, fireworks for new year's eve).
 - **Easy Integration**: No manual file editing required. The plugin injects everything automatically.
-- **Configuration UI**: Configure settings directly in the Jellyfin Dashboard (very basic for now, needs some work in the future).
+- **Configuration UI**: Configure settings directly in the Jellyfin Dashboard.
+    <details>
+    <summary>Have a look:</summary>
+    <img width="852" height="782" alt="Admin-Settings" src="https://github.com/user-attachments/assets/03d04ea8-7dd9-418e-88f8-9ae2937c06bb" />
+    </details>
+- **User Toggle**: Optionally allow users to enable/disable seasonal effects from their client.
+    <details>
+    <summary>Have a look:</summary>
+    <img width="467" height="263" alt="Client-Settings" src="https://github.com/user-attachments/assets/a8dfc90a-16c8-409c-9133-4139f6527b0b" />
+    </details>
 
 ## Overview
+Click on the following themes to expand them and see the theme in action:
+
+<details>
+<summary>Easter</summary>
 
-**Easter**
 ![easter](https://github.com/user-attachments/assets/63665099-5c3c-4209-be6e-dda3686b2a49)
+</details>
+
+<details>
+<summary>Autumn</summary>
 
-**Autumn**
 ![autumn](https://github.com/user-attachments/assets/df27d61c-d2d6-4776-82d7-89bf789a7462)
+</details>
+
+<details>
+<summary>Santa</summary>
 
-**Santa**
 ![Santa-10](https://github.com/user-attachments/assets/a69b0aa3-537d-4463-b6bc-166f0a316c37)
+</details>
+
+<details>
+<summary>Christmas</summary>
 
-**Christmas**
 ![christmas](https://github.com/user-attachments/assets/e70a425d-866f-4617-bbfe-3c03e3654717)
+</details>
+
+<details>
+<summary>Fireworks</summary>
 
-**Fireworks**
 ![fireworks](https://github.com/user-attachments/assets/6c8b629e-b338-4dde-910b-c832aa29d77d)
+</details>
+
+<details>
+<summary>Halloween</summary>
 
-**Halloween**
 ![halloween](https://github.com/user-attachments/assets/221a1390-847e-45a4-b8eb-dc5b45d5df5c)
+</details>
+
+<details>
+<summary>Hearts</summary>
 
-**Hearts**
 ![hearts](https://github.com/user-attachments/assets/e084cb0c-246e-4234-b6dd-d561923c6c91)
+</details>
+
+<details>
+<summary>Snowfall</summary>
 
-**Snowfall**
 ![snowfall](https://github.com/user-attachments/assets/24bfdd84-f354-4129-933c-bb29b4180517)
+</details>
+
+<details>
+<summary>Snowflakes</summary>
 
-**Snowflakes**
 ![snowflakes](https://github.com/user-attachments/assets/78f2e925-8cf6-4a0b-8a25-f05594de4efd)
+</details>
+
+<details>
+<summary>Snowstorm</summary>
 
-**Snowstorm**
 ![snowstorm](https://github.com/user-attachments/assets/6fd726d2-34d1-4f80-8ed6-2f482155059f)
+</details>
+
+
+## Ideas for additional seasonals
+If you have any (specific) ideas for additional seasonals, feel free to open an issue or create a pull request.
 
 ## Installation
 
+This plugin is based on Jellyfin Version `10.11.x`
+
 To install this plugin, you will first need to add the repository in Jellyfin.
 
 1.  Open your Jellyfin Dashboard.
-2.  Navigate to **Plugins** > **Repositories**.
+2.  Navigate to **Plugins** > **Manage Repositories**.
-3.  Click the **+** sign to add a new repository.
+3.  Click the **+ New Repository** button to add a new repository.
-4.  Enter a name (e.g., "Seasonals") and paste the following URL into the 'Repository URL' field:
+4.  Enter a name for the repo and paste the following URL into the 'Repository URL' field:
    ```bash
-   https://raw.githubusercontent.com/CodeDevMLH/jellyfin-plugin-seasonals/main/manifest.json
+   https://raw.githubusercontent.com/CodeDevMLH/jellyfin-plugin-manifest/refs/heads/main/manifest.json
    ```
-5.  Click **Save**.
+5.  Click **Add**.
-6.  Go to the **Catalog** tab at the top.
+6.  Go to the **Available** tab at the top.
-7.  Under **General**, find the **Seasonals** plugin.
+7.  Find the **Seasonals** plugin (Under **General**)
 8.  Click on it and select **Install**.
 9.  **Restart your Jellyfin server.**
 10. **You may need to refresh your browser page** (F5 or Ctrl+R) to see the changes. 
 
-## Usage
+## Client Compatibility
+
+Since this plugin relies on modifying the web interface (CSS/JS injection), it only works on clients that use the web wrapper. Native clients that use their own UI rendering engine are not supported.
+
+| Client Platform | Status | Notes |
+| :--- | :---: | :--- |
+| **Web Browsers** (Firefox, Chrome etc.) | ✅ | Direct JS injection |
+| **Jellyfin Media Player** (Windows/Linux/macOS) | ✅ | Uses jellyfin web |
+| **Android App** | ✅ | Uses a web wrapper |
+| **iOS App** | ✅ | Uses a web wrapper |
+| **Android TV / Fire TV** | ❌ | **Not supported.** Uses a native Java/Kotlin UI. |
+| **Roku** | ❌ | **Not supported.** Uses a native UI. |
+| **Swiftfin** (iOS/tvOS) | ❌ | **Not supported.** Uses a native Swift UI. |
+| **Kodi** (via Jellyfin Addon) | ❌ | **Not supported.** Uses Kodi's native skinning engine. |
+
+## Configuration
 
 After installation and restart:
 
 1.  Go to **Dashboard** > **Plugins** > **Seasonals**.
 2.  **Enable Seasonals**: Toggle the plugin on or off.
 3.  **Automatic Selection**:
-    *   If enabled, the plugin selects the theme based on the current date (e.g., Snow in Winter, Hearts in February).
+    *   If enabled, the plugin selects the theme based on the current date (e.g., Snow in Winter, Hearts in February). See the table below for details.
     *   If disabled, you can manually select a theme from the dropdown list.
 4.  **Save** your settings.
 5.  **Reload your browser page** (F5 or Ctrl+R) to see the changes.
 
-## Build Process
+## Automatic Theme Selection
+If automatic selection is enabled, the following themes are applied based on the date. Specific holiday events take precedence over general seasonal themes.:
+
+| Theme | Active Period | Description |
+| :--- | :--- | :--- |
+| **`santa`** | Dec 22 – Dec 27 | Christmas theme |
+| **`fireworks`** | Dec 28 – Jan 05 | New Year's celebration |
+| **`hearts`** | Feb 10 – Feb 18 | Valentine's Day |
+| **`easter`** | Mar 25 – Apr 25 | Easter theme |
+| **`halloween`** | Oct 24 – Nov 05 | Halloween theme |
+| **`snowflakes`** | December (Remainder) | General December winter theme |
+| **`snowfall`** | January & February | General winter theme (outside of holidays) |
+| **`autumn`** | Sep, Oct, Nov | Fall theme (when not Halloween) |
+| **`none`** | All other dates | Default appearance |
+
+> **Note:** Holiday themes (like `santa` or `fireworks`) override monthly seasonal themes (like `snowflakes`).
+
+## Theme Settings
+Each theme contains additional settings to customize its behavior. Expand the advanced configuration section to configure each theme, adjust parameters like particle count, animation speed etc.
+
+## Build the plugin by yourself
 
 If you want to build the plugin yourself:
 
@@ -103,120 +188,59 @@ If you want to build the plugin yourself:
     ```
 4.  The compiled DLL and resources will be in bin/Publish.
 
+## Troubleshooting
+
+### Effects Not Showing
+1. **Verify plugin installation**:
+   - Check that the plugin appears in the jellyfin admin panel
+   - Ensure that the plugin is enabled and active
+
+2. **Clear browser cache**:
+   - Force refresh browser (Ctrl+F5)
+   - Clear jellyfin web client cache (--> mostly you have to clear the whole browser cache)
+
+### Docker Permission Issues
+If you encounter the message `Access was denied when attempting to inject script into index.html. Automatic direct injection failed. Automatic direct insertion failed. The system will now attempt to use the File Transformation plugin.` in the log or similar permission errors in Docker:
+
+**Option 1: Use File Transformation Plugin (Recommended)**
+
+Seasonals now automatically detects and uses the [File Transformation](https://github.com/IAmParadox27/jellyfin-plugin-file-transformation) plugin (v2.5.0.0+) if it's installed. This eliminates permission issues by transforming content at runtime without modifying files on disk.
+
+**Installation Steps:**
+1. Install the File Transformation plugin from the Jellyfin plugin catalog
+2. Restart Jellyfin
+3. Seasonals will automatically detect and use it (no configuration needed)
+4. Check logs to confirm: Look for "Successfully registered transformation with File Transformation plugin"
+
+**Benefits:**
+- No file permission issues in Docker environments
+- Works with read-only web directories
+- Survives Jellyfin updates without re-injection
+- No manual file modifications required
+
+**Option 2: Fix File Permissions**
+```bash
+# Find the actual index.html location
+docker exec -it jellyfin find / -name index.html
+
+# Fix ownership (replace 'jellyfin' with your container name and adjust user:group if needed)
+docker exec -it --user root jellyfin chown jellyfin:jellyfin /jellyfin/jellyfin-web/index.html
+
+# Restart container
+docker restart jellyfin
+```
+
+**Option 3: Manual Volume Mapping**
+```bash
+# Extract index.html from container
+docker cp jellyfin:/jellyfin/jellyfin-web/index.html /path/to/jellyfin/config/index.html
+
+# Add to docker-compose.yml volumes section:
+volumes:
+  - /path/to/jellyfin/config/index.html:/jellyfin/jellyfin-web/index.html
+```
+
 ## Contributing
 
 Feel free to contribute to this project by creating pull requests or reporting issues.
 
----
-
-## Legacy Manual Installation
-
-<details>
-<summary>Click to expand instructions for the old manual installation method (without plugin)</summary>
-
-### Installation
-
-> [!TIP]
-> Take a look at [CodeDevMLH/Jellyfin-Mods-Automated-Script](https://github.com/CodeDevMLH/Jellyfin-Mods-Automated-Script)
-
-1. **Add Seasonal Container to `index.html`**  
-   Edit the `index.html` file of your Jellyfin web instance. Add the following code inside the `<body>` tag:
-
-   ```html
-   <div class="seasonals-container"></div>
-   <script src="seasonals/seasonals.js"></script>
-    ```
-2. **Deploy Files**  
-    Place the seasonals folder (including seasonals.js, CSS, and additional JavaScript files for each theme [this one](https://github.com/CodeDevMLH/Jellyfin-Seasonals/tree/main/seasonals)) inside the Jellyfin web server directory (labeld with "web").
-
-3. **Configure Themes**  
-    Customize the theme-configs.js file to modify or add new themes. The default configuration is shown below:
-
-    ```javascript
-    const automateThemeSelection = true; // Set to false to disable automatic theme selection based on current date
-    const defaultTheme = 'none';    // Default theme if automatic selection is off
-
-    const themeConfigs = {
-        snowflakes: {
-            css: 'seasonals/snowflakes.css',
-            js: 'seasonals/snowflakes.js',
-            containerClass: 'snowflakes'
-        },
-        snowfall: {
-            css: 'seasonals/snowfall.css',
-            js: 'seasonals/snowfall.js',
-            containerClass: 'snowfall-container'
-        },
-        
-        // more configs...
-
-        none: {
-            containerClass: 'none'
-        },
-    };
-    ```
-
-4. **Reload the web interface**  
-    After making these changes, restart your Jellyfin server and/or refresh the web interface (ctrl+F5, sometimes you need to clear the browsers temp files/cache (every time with firefox ;-()) to see the changes.
-
-### Theme Settings
-Each theme's JavaScript file contains additional settings to customize its behavior. Here are examples for the `autumn` and `snowflakes` themes:
-
-**Autumn Theme Settings**
-```javascript
-const leaves = true; // Enable/disable leaves
-const randomLeaves = true; // Enable random leaves
-const randomLeavesMobile = false; // Enable random leaves on mobile devices
-const enableDiffrentDuration = true; // Enable different animation duration for random leaves
-const leafCount = 25; // Number of random extra leaves
-```
-
-**Snowflakes Theme Settings**
-```javascript
-const snowflakes = true; // Enable/disable snowflakes
-const randomSnowflakes = true; // Enable random snowflakes
-const randomSnowflakesMobile = false; // Enable random snowflakes on mobile devices
-const enableColoredSnowflakes = true; // Enable colored snowflakes on mobile devices
-const enableDiffrentDuration = true; // Enable different animation duration for random snowflakes
-const snowflakeCount = 25; // Number of random extra snowflakes
-```
-
-### Usage
-**Automatic Theme Selection**  
-By default, the theme is automatically selected based on the date. For example:
-
-    Snowfall: January
-    Hearts: February (Valentine's Day)
-    Halloween: October
-
-Modify the determineCurrentTheme() function in seasonals.js to adjust date-based logic.
-
-**Manual Theme Selection**  
-To use a fixed theme, set automateThemeSelection to false in the theme-configs.js file and specify a defaultTheme.
-
-**Custom Themes**  
-1. Add your CSS and JavaScript files to the seasonals folder.
-   
-2. Extend the themeConfigs object with your theme details:
-    ```javascript
-    myTheme: {
-        css: 'seasonals/my-theme.css',
-        js: 'seasonals/my-theme.js',
-        containerClass: 'my-theme-container',
-    }
-    ```
-
-
-### Additional Directory: Separate Single Seasonals
-For users who prefer not to use the automatic seasonal theme selection, individual seasonals are available in the `separate single seasonals` folder. Each seasonal theme can be independently loaded and used without relying on the main automatic selection system.
-
-but this requires to the modify of the `index.html` with adding the html in `add_to_index_html`.
-
-To use a single seasonal theme, include its specific CSS and JS files in your `index.html` inside the `<body> </body>` tags provided by `add_to_index_html.html` in the sub-theme-folders as shown below:
-
-```html
-<div class="seasonalsname-container"></div>
-<script src="separate single seasonals/snowflakes.js"></script>
-<link rel="stylesheet" href="separate single seasonals/snowflakes.css">
-
-</details>

RELEASE_GUIDE.md

@@ -9,10 +9,7 @@ Bevor du baust, musst du die Versionsnummer in den folgenden Dateien aktualisier
 1.  **`Jellyfin.Plugin.Seasonals/Jellyfin.Plugin.Seasonals.csproj`**
     Suche nach `<Version>...</Version>` und ändere die Nummer.
 
-2.  **`build.yaml`**
+2.  **`manifest.json`**
-    Ändere den Wert bei `version: "..."`.
-
-3.  **`manifest.json`**
     Füge einen neuen Eintrag oben in die `versions`-Liste ein (oder bearbeite den vorhandenen, wenn es noch kein Release gab).
     *   `version`: Deine neue Nummer.
     *   `changelog`: Was hat sich geändert?

bin/Publish/Jellyfin.Plugin.Seasonals.deps.json

@@ -1,624 +0,0 @@
-{
-  "runtimeTarget": {
-    "name": ".NETCoreApp,Version=v9.0",
-    "signature": ""
-  },
-  "compilationOptions": {},
-  "targets": {
-    ".NETCoreApp,Version=v9.0": {
-      "Jellyfin.Plugin.Seasonals/1.0.0.0": {
-        "dependencies": {
-          "Jellyfin.Controller": "10.11.0",
-          "Jellyfin.Model": "10.11.0"
-        },
-        "runtime": {
-          "Jellyfin.Plugin.Seasonals.dll": {}
-        }
-      },
-      "BitFaster.Caching/2.5.4": {
-        "runtime": {
-          "lib/net6.0/BitFaster.Caching.dll": {
-            "assemblyVersion": "2.5.4.0",
-            "fileVersion": "2.5.4.0"
-          }
-        }
-      },
-      "Diacritics/4.0.17": {
-        "runtime": {
-          "lib/net9.0/Diacritics.dll": {
-            "assemblyVersion": "4.0.17.0",
-            "fileVersion": "4.0.17.0"
-          }
-        }
-      },
-      "ICU4N/60.1.0-alpha.356": {
-        "dependencies": {
-          "J2N": "2.0.0",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10"
-        },
-        "runtime": {
-          "lib/netstandard2.0/ICU4N.dll": {
-            "assemblyVersion": "60.0.0.0",
-            "fileVersion": "60.1.0.0"
-          }
-        }
-      },
-      "ICU4N.Transliterator/60.1.0-alpha.356": {
-        "dependencies": {
-          "ICU4N": "60.1.0-alpha.356"
-        },
-        "runtime": {
-          "lib/netstandard2.0/ICU4N.Transliterator.dll": {
-            "assemblyVersion": "60.0.0.0",
-            "fileVersion": "60.1.0.0"
-          }
-        }
-      },
-      "J2N/2.0.0": {
-        "runtime": {
-          "lib/net6.0/J2N.dll": {
-            "assemblyVersion": "2.0.0.0",
-            "fileVersion": "2.0.0.0"
-          }
-        }
-      },
-      "Jellyfin.Common/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Model": "10.11.0",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Common.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Controller/10.11.0": {
-        "dependencies": {
-          "BitFaster.Caching": "2.5.4",
-          "Jellyfin.Common": "10.11.0",
-          "Jellyfin.MediaEncoding.Keyframes": "10.11.0",
-          "Jellyfin.Model": "10.11.0",
-          "Jellyfin.Naming": "10.11.0",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Configuration.Binder": "9.0.10",
-          "System.Threading.Tasks.Dataflow": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Controller.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Data/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Database.Implementations": "10.11.0",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Data.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Database.Implementations/10.11.0": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore.Relational": "9.0.10",
-          "Polly": "8.6.4"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Database.Implementations.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Extensions/10.11.0": {
-        "dependencies": {
-          "Diacritics": "4.0.17",
-          "ICU4N.Transliterator": "60.1.0-alpha.356"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.Extensions.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.MediaEncoding.Keyframes/10.11.0": {
-        "dependencies": {
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "NEbml": "1.1.0.5"
-        },
-        "runtime": {
-          "lib/net9.0/Jellyfin.MediaEncoding.Keyframes.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Model/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Data": "10.11.0",
-          "Jellyfin.Extensions": "10.11.0",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "System.Globalization": "4.3.0",
-          "System.Text.Json": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/MediaBrowser.Model.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Jellyfin.Naming/10.11.0": {
-        "dependencies": {
-          "Jellyfin.Common": "10.11.0",
-          "Jellyfin.Model": "10.11.0"
-        },
-        "runtime": {
-          "lib/net9.0/Emby.Naming.dll": {
-            "assemblyVersion": "10.11.0.0",
-            "fileVersion": "10.11.0.0"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore/9.0.10": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore.Abstractions": "9.0.10",
-          "Microsoft.EntityFrameworkCore.Analyzers": "9.0.10",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore.Abstractions/9.0.10": {
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.Abstractions.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.EntityFrameworkCore.Analyzers/9.0.10": {},
-      "Microsoft.EntityFrameworkCore.Relational/9.0.10": {
-        "dependencies": {
-          "Microsoft.EntityFrameworkCore": "9.0.10",
-          "Microsoft.Extensions.Caching.Memory": "9.0.10",
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Logging": "9.0.10"
-        },
-        "runtime": {
-          "lib/net8.0/Microsoft.EntityFrameworkCore.Relational.dll": {
-            "assemblyVersion": "9.0.10.0",
-            "fileVersion": "9.0.1025.47514"
-          }
-        }
-      },
-      "Microsoft.Extensions.Caching.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Caching.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Caching.Memory/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Caching.Abstractions": "9.0.10",
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Options": "9.0.10",
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Caching.Memory.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Configuration.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Configuration.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Configuration.Binder/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.Configuration.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Configuration.Binder.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.DependencyInjection/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.DependencyInjection.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.DependencyInjection.Abstractions/9.0.10": {
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.DependencyInjection.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Logging/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection": "9.0.10",
-          "Microsoft.Extensions.Logging.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Options": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Logging.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Logging.Abstractions/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Logging.Abstractions.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Options/9.0.10": {
-        "dependencies": {
-          "Microsoft.Extensions.DependencyInjection.Abstractions": "9.0.10",
-          "Microsoft.Extensions.Primitives": "9.0.10"
-        },
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Options.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.Extensions.Primitives/9.0.10": {
-        "runtime": {
-          "lib/net9.0/Microsoft.Extensions.Primitives.dll": {
-            "assemblyVersion": "9.0.0.0",
-            "fileVersion": "9.0.1025.47515"
-          }
-        }
-      },
-      "Microsoft.NETCore.Platforms/1.1.0": {},
-      "Microsoft.NETCore.Targets/1.1.0": {},
-      "NEbml/1.1.0.5": {
-        "runtime": {
-          "lib/netstandard2.0/NEbml.Core.dll": {
-            "assemblyVersion": "1.1.0.5",
-            "fileVersion": "1.1.0.5"
-          }
-        }
-      },
-      "Polly/8.6.4": {
-        "dependencies": {
-          "Polly.Core": "8.6.4"
-        },
-        "runtime": {
-          "lib/net6.0/Polly.dll": {
-            "assemblyVersion": "8.0.0.0",
-            "fileVersion": "8.6.4.5033"
-          }
-        }
-      },
-      "Polly.Core/8.6.4": {
-        "runtime": {
-          "lib/net8.0/Polly.Core.dll": {
-            "assemblyVersion": "8.0.0.0",
-            "fileVersion": "8.6.4.5033"
-          }
-        }
-      },
-      "System.Globalization/4.3.0": {
-        "dependencies": {
-          "Microsoft.NETCore.Platforms": "1.1.0",
-          "Microsoft.NETCore.Targets": "1.1.0",
-          "System.Runtime": "4.3.0"
-        }
-      },
-      "System.Runtime/4.3.0": {
-        "dependencies": {
-          "Microsoft.NETCore.Platforms": "1.1.0",
-          "Microsoft.NETCore.Targets": "1.1.0"
-        }
-      },
-      "System.Text.Json/9.0.10": {},
-      "System.Threading.Tasks.Dataflow/9.0.10": {}
-    }
-  },
-  "libraries": {
-    "Jellyfin.Plugin.Seasonals/1.0.0.0": {
-      "type": "project",
-      "serviceable": false,
-      "sha512": ""
-    },
-    "BitFaster.Caching/2.5.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-1QroTY1PVCZOSG9FnkkCrmCKk/+bZCgI/YXq376HnYwUDJ4Ho0EaV4YaA/5v5WYLnwIwIO7RZkdWbg9pxIpueQ==",
-      "path": "bitfaster.caching/2.5.4",
-      "hashPath": "bitfaster.caching.2.5.4.nupkg.sha512"
-    },
-    "Diacritics/4.0.17": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-FmMvVQRsfon+x5P+dxz4mvV8wt45xr25EAOCkuo/Cjtc7lVYV5cZUSsNXwmKQpwO+TokIHpzxb8ENpqrm4yBlQ==",
-      "path": "diacritics/4.0.17",
-      "hashPath": "diacritics.4.0.17.nupkg.sha512"
-    },
-    "ICU4N/60.1.0-alpha.356": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-YMZtDnjcqWzziOKiE7w6Ma7Rl5vuFDxzOsUlHh1QyfghbNEIZQOLRs9MMfwCWAjX6n9UitrF6vLXy55Z5q+4Fg==",
-      "path": "icu4n/60.1.0-alpha.356",
-      "hashPath": "icu4n.60.1.0-alpha.356.nupkg.sha512"
-    },
-    "ICU4N.Transliterator/60.1.0-alpha.356": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-lFOSO6bbEtB6HkWMNDJAq+rFwVyi9g6xVc5O/2xHa6iZnV7wLVDqCbaQ4W4vIeBSQZAafqhxciaEkmAvSdzlCg==",
-      "path": "icu4n.transliterator/60.1.0-alpha.356",
-      "hashPath": "icu4n.transliterator.60.1.0-alpha.356.nupkg.sha512"
-    },
-    "J2N/2.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-M5bwDajAARZiyqupU+rHQJnsVLxNBOHJ8vKYHd8LcLIb1FgLfzzcJvc31Qo5Xz/GEHFjDF9ScjKL/ks/zRTXuA==",
-      "path": "j2n/2.0.0",
-      "hashPath": "j2n.2.0.0.nupkg.sha512"
-    },
-    "Jellyfin.Common/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-TitN7+qWFt2l0V5b+KTRt7ABDCvfZdvSC6qBG1uHS18Y80xrbrSCJ9O6BH/of310h6a4lxKlQjUtTPHCzeG2AA==",
-      "path": "jellyfin.common/10.11.0",
-      "hashPath": "jellyfin.common.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Controller/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-WV+PQy9AHdZLvYqUsNq6ZyQoxaiaEWLz0EwZGOiu8xSrepQLFope2U1VFHVCNbARwesg7s/B+9uB03eXDsQw9w==",
-      "path": "jellyfin.controller/10.11.0",
-      "hashPath": "jellyfin.controller.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Data/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-YEz7/85b98Rj14IJJIVqmzJsi69LDOKo4Ox+VHbh1vj3tkWomSPayzvG3kyU8I0yFMrd6+Ta55C20kZ2XC7vQg==",
-      "path": "jellyfin.data/10.11.0",
-      "hashPath": "jellyfin.data.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Database.Implementations/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-oLblVZzqF9zuLMdfqp8pbusSVQq6b40/RcHjGF1hxYozVNEi+UhiDX8aJipYBOrh33FFAofoQq468BvZixpPcw==",
-      "path": "jellyfin.database.implementations/10.11.0",
-      "hashPath": "jellyfin.database.implementations.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Extensions/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-1ufj+Rm0Bn6C990i2wwiT5UHPZfD65GOtJK6NcDU//DDMbuoGX1LQZxuCx+rhhRg1XdHPWzYASARYyNlFQa6cg==",
-      "path": "jellyfin.extensions/10.11.0",
-      "hashPath": "jellyfin.extensions.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.MediaEncoding.Keyframes/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-/OBcg4Qj825elOGNj5bNRfABKzfAf4qNQj0/d/DwhG/+V/wsKuxS0Pc/xOEagVVjXOnqGPZz/+k8D4UvnvMoHw==",
-      "path": "jellyfin.mediaencoding.keyframes/10.11.0",
-      "hashPath": "jellyfin.mediaencoding.keyframes.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Model/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-h+61RSXn4sk8fS6Zx9RkDyVnI5VnNbrsR2p8WcvybtNSW2pgU2uZ9pwEv2awD3ifX69weqYpQLMh91f6aidW2A==",
-      "path": "jellyfin.model/10.11.0",
-      "hashPath": "jellyfin.model.10.11.0.nupkg.sha512"
-    },
-    "Jellyfin.Naming/10.11.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-2++xSbhdFSb1J3XySjC6UU+uII6OdKc0DfkYx/E1oN7mSjoftyZR8eU045kVWBwsAxr+UcMI6t2DYfES2tJkRA==",
-      "path": "jellyfin.naming/10.11.0",
-      "hashPath": "jellyfin.naming.10.11.0.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-WjjxVyOTVs85V7SUe+lZjtGOEeVzF4RO8amrqL4adgbyThNq7vGCFzPw8buZj44gHeQYD5V/uZ/6XuqG9Jq+kA==",
-      "path": "microsoft.entityframeworkcore/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-I3TWAs5Lbzmzu8S0T6qXhzBiO3CznYLrfE59W0npkqNHfWGH8CgA66LrHMWxWOXVTD4145QwYqiWNCdLwpJ1Ew==",
-      "path": "microsoft.entityframeworkcore.abstractions/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Analyzers/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-mXNl0Gg3l3zGrClLCHepB+b7rYVuFfB9qQJwya0dUSHFuR1T0jMD8KxuNVyhQSfoWIepanhzjcG8TUNGXOcU0Q==",
-      "path": "microsoft.entityframeworkcore.analyzers/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.analyzers.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.EntityFrameworkCore.Relational/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-IJNrG5vdmFUvHR8FLLFg9AWpuE8qW1DTEN+fNLGbNTu6cnpZzzqU6+aknAGtTSAEVWosJ3BZ3TOO9wpifUvv3A==",
-      "path": "microsoft.entityframeworkcore.relational/9.0.10",
-      "hashPath": "microsoft.entityframeworkcore.relational.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Caching.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-cL6iTxgJ4u5zP3eFOdBiDAtmE/B2WKTRhyJfEne7n6qvHpsMwwIDxljs210mWSO1ucBy7lR1Lo7/7kjeZeLcqQ==",
-      "path": "microsoft.extensions.caching.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.caching.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Caching.Memory/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-2iuzwIoCoqZJfH2VLk1xvlQS4PQDEuhj4dWiGb+Qpt1vHFHyffp497cTO6ucsV54W/h4JmM1vzDBv8pVAFazZg==",
-      "path": "microsoft.extensions.caching.memory/9.0.10",
-      "hashPath": "microsoft.extensions.caching.memory.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Configuration.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-ad3JxmFj0uxuFa1CT6oxTCC1lQ0xeRuOvzBRFT/I/ofIXVOnNsH/v2GZkAJWhlpZqKUvSexQZzp3EEAB2CdtJg==",
-      "path": "microsoft.extensions.configuration.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.configuration.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Configuration.Binder/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-D6Kng+9I+w1SQPxJybc6wzw9nnnyUQPutycjtI0svv1RHaWOpUk9PPlwIRfhhoQZ3yihejkEI2wNv/7VnVtkGA==",
-      "path": "microsoft.extensions.configuration.binder/9.0.10",
-      "hashPath": "microsoft.extensions.configuration.binder.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.DependencyInjection/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-iEtXCkNd5XhjNJAOb/wO4IhDRdLIE2CsPxZggZQWJ/q2+sa8dmEPC393nnsiqdH8/4KV8Xn25IzgKPR1UEQ0og==",
-      "path": "microsoft.extensions.dependencyinjection/9.0.10",
-      "hashPath": "microsoft.extensions.dependencyinjection.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.DependencyInjection.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-r9waLiOPe9ZF1PvzUT+RDoHvpMmY8MW+lb4lqjYGObwKpnyPMLI3odVvlmshwuZcdoHynsGWOrCPA0hxZ63lIA==",
-      "path": "microsoft.extensions.dependencyinjection.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.dependencyinjection.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Logging/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-UBXHqE9vyptVhaFnT1R7YJKCve7TqVI10yjjUZBNGMlW2lZ4c031Slt9hxsOzWCzlpPxxIFyf1Yk4a6Iubxx7w==",
-      "path": "microsoft.extensions.logging/9.0.10",
-      "hashPath": "microsoft.extensions.logging.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Logging.Abstractions/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-MFUPv/nN1rAQ19w43smm6bbf0JDYN/1HEPHoiMYY50pvDMFpglzWAuoTavByDmZq7UuhjaxwrET3joU69ZHoHQ==",
-      "path": "microsoft.extensions.logging.abstractions/9.0.10",
-      "hashPath": "microsoft.extensions.logging.abstractions.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Options/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-zMNABt8eBv0B0XrWjFy9nZNgddavaOeq3ZdaD5IlHhRH65MrU7HM+Hd8GjWE3e2VDGFPZFfSAc6XVXC17f9fOA==",
-      "path": "microsoft.extensions.options/9.0.10",
-      "hashPath": "microsoft.extensions.options.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.Extensions.Primitives/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-3pl8D1O5ZwMpDkZAT2uXrhQ6NipkwEgDLMFuURiHTf72TvkoMP61QYH3Vk1yrzVHnHBdNZk3cQACz8Zc7YGNhQ==",
-      "path": "microsoft.extensions.primitives/9.0.10",
-      "hashPath": "microsoft.extensions.primitives.9.0.10.nupkg.sha512"
-    },
-    "Microsoft.NETCore.Platforms/1.1.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-kz0PEW2lhqygehI/d6XsPCQzD7ff7gUJaVGPVETX611eadGsA3A877GdSlU0LRVMCTH/+P3o2iDTak+S08V2+A==",
-      "path": "microsoft.netcore.platforms/1.1.0",
-      "hashPath": "microsoft.netcore.platforms.1.1.0.nupkg.sha512"
-    },
-    "Microsoft.NETCore.Targets/1.1.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-aOZA3BWfz9RXjpzt0sRJJMjAscAUm3Hoa4UWAfceV9UTYxgwZ1lZt5nO2myFf+/jetYQo4uTP7zS8sJY67BBxg==",
-      "path": "microsoft.netcore.targets/1.1.0",
-      "hashPath": "microsoft.netcore.targets.1.1.0.nupkg.sha512"
-    },
-    "NEbml/1.1.0.5": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-svtqDc+hue9kbnqNN2KkK4om/hDrc7K127cNb5FIYfgKgzo+JNDPXNLp8NioCchHhBO3lxWd4Cp/iiZZ3aoUqg==",
-      "path": "nebml/1.1.0.5",
-      "hashPath": "nebml.1.1.0.5.nupkg.sha512"
-    },
-    "Polly/8.6.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-uuBsDoBw0oYrMe3uTWRjkT2sIkKh+ZZnnDrLb4Z+QANfeA4+7FJacx6E8CY5GAxXRoSgFrvUADEAQ7DPF6fGiw==",
-      "path": "polly/8.6.4",
-      "hashPath": "polly.8.6.4.nupkg.sha512"
-    },
-    "Polly.Core/8.6.4": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-4AWqYnQ2TME0E+Mzovt1Uu+VyvpR84ymUldMcPw7Mbj799Phaag14CKrMtlJGx5jsvYP+S3oR1QmysgmXoD5cw==",
-      "path": "polly.core/8.6.4",
-      "hashPath": "polly.core.8.6.4.nupkg.sha512"
-    },
-    "System.Globalization/4.3.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-kYdVd2f2PAdFGblzFswE4hkNANJBKRmsfa2X5LG2AcWE1c7/4t0pYae1L8vfZ5xvE2nK/R9JprtToA61OSHWIg==",
-      "path": "system.globalization/4.3.0",
-      "hashPath": "system.globalization.4.3.0.nupkg.sha512"
-    },
-    "System.Runtime/4.3.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-JufQi0vPQ0xGnAczR13AUFglDyVYt4Kqnz1AZaiKZ5+GICq0/1MH/mO/eAJHt/mHW1zjKBJd7kV26SrxddAhiw==",
-      "path": "system.runtime/4.3.0",
-      "hashPath": "system.runtime.4.3.0.nupkg.sha512"
-    },
-    "System.Text.Json/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-XM02ZBnzxk7Ti6l9YRy8Bp639wANqJzJzw4W4VYiCh+HXY9hBOWkGB4k89OLP/s/RxgM02P4a/mWcJTgFiLf1Q==",
-      "path": "system.text.json/9.0.10",
-      "hashPath": "system.text.json.9.0.10.nupkg.sha512"
-    },
-    "System.Threading.Tasks.Dataflow/9.0.10": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-k1o6v6V3+4mznSnPnO0FBaRjiAPL1ouKPfPQH7hO9Z2SwJHt8E45F4wX5yQh1aeja1JHPYEungQedXibng654Q==",
-      "path": "system.threading.tasks.dataflow/9.0.10",
-      "hashPath": "system.threading.tasks.dataflow.9.0.10.nupkg.sha512"
-    }
-  }
-}

build.yaml

@@ -1,15 +0,0 @@
----
-name: "Seasonals"
-guid: "ef1e863f-cbb0-4e47-9f23-f0cbb1826ad4"
-version: "1.0.0.0"
-targetAbi: "10.11.0.0"
-framework: "net9.0"
-overview: "Seasonal effects for Jellyfin"
-description: >
-  Adds seasonal effects like snow, leaves, etc. to the Jellyfin web interface.
-category: "General"
-owner: "CodeDevMLH"
-artifacts:
-- "Jellyfin.Plugin.Seasonals.dll"
-changelog: >
-  Initial release

git_cheat_sheet.md

@@ -0,0 +1,163 @@
+# 🚀 Git Cheat Sheet: Branches, Merge, Rebase & VS Code
+
+## 🌳 Branches (Zweige)
+* **`main`** → Stabiler Stand, Production-ready (Deployment).
+* **`dev`** → Aktive Entwicklung, Sammelbecken für Features.
+
+---
+
+## 🛠 Zusammenführen von Änderungen
+
+### Git Merge
+Führt zwei Zweige zusammen. Git sucht den letzten gemeinsamen Basispunkt und erstellt einen neuen **Merge-Commit**.
+
+```bash
+git checkout dev
+git merge main
+```
+
+| Details   |        |
+|-----------|--------|
+| Wann?     | In Team-Branches, bei bereits gepushten Branches, wenn Stabilität wichtiger als eine saubere History ist. |
+| Vorteile  | Sicher, einfach nachvollziehbar, schreibt die History nicht um. |
+| Nachteile | Die History kann bei vielen Merges unübersichtlich ("Spaghetti-Graph") werden. |
+
+### Git Rebase
+Setzt deine Commits neu auf die Spitze eines anderen Branches. Die Commit-IDs werden dabei neu geschrieben.
+
+```bash
+git stash		  # (optional) Änderungen parken.
+git checkout dev
+git fetch origin
+git rebase origin/main
+git stash pop	  # (optional) Änderungen zurückholen.
+```
+
+| Details   |        |
+|-----------|--------|
+| Wann?     | In lokalen Feature-Branches (bevor sie geteilt werden), um die History sauber zu halten. |
+| Vorteile  | Erzeugt eine perfekt lineare, leicht lesbare History. |
+| Nachteile | ⚠️ Gefährlich auf geteilten/öffentlichen Branches. Konflikte müssen ggf. für jeden einzelnen Commit gelöst werden. |
+
+---
+
+## **Git: dev zurücksetzen & „main ist Chef“**
+
+Problem
+
+Beim Arbeiten mit Git passiert oft Folgendes:
+
+- `dev` hat Commits, die nicht in `main` sind
+- diese Commits brauche ich nicht mehr
+- beim `git rebase origin/main` will Git trotzdem mergen oder Konflikte lösen
+
+⚠️ Wichtiges Missverständnis:
+
+Das sind keine lokalen Änderungen, sondern Commits, die auf `dev` existieren.
+
+`git reset --hard origin/dev` entfernt nur lokale, nicht gepushte Commits,
+aber nicht Commits, die bereits auf `origin/dev` liegen.
+
+Praktische Befehle & sichere Vorgehensweise
+
+- Prüfen — welche Commits würden entfernt werden:
+
+```bash
+git fetch origin
+git log --oneline origin/main..origin/dev
+```
+
+- Optional: Backup des aktuellen `origin/dev`, falls etwas schiefgeht:
+
+```bash
+git fetch origin
+git branch backup/dev origin/dev
+```
+
+- Sicheres Zurücksetzen von `dev` auf `main` (lokal + remote):
+
+```bash
+git checkout dev
+git fetch origin
+git reset --hard origin/main
+git push --force-with-lease origin dev
+```
+
+- Alternative (ohne lokalen Checkout): Push von `main` direkt nach `dev`:
+
+```bash
+git fetch origin
+git push --force-with-lease origin origin/main:refs/heads/dev
+```
+
+- Warnung: Diese Aktionen schreiben die Remote‑History um. Koordiniere dich mit
+	dem Team bevor du ein Force‑Push ausführst. Verwende `--force-with-lease`
+	anstelle von `--force` für etwas mehr Sicherheit.
+
+
+## 📦 Temporäres Speichern & Spezialbefehle
+
+### Stash (Das "Regal")
+Speichert uncommitted Changes temporär, um das Arbeitsverzeichnis sauber zu machen, ohne zu committen.
+
+```bash
+git stash        # Änderungen "parken".
+git stash pop    # Änderungen zurückholen und Stash leeren.
+```
+
+**Wann?** Wenn du schnell den Branch wechseln musst, aber deine Arbeit noch nicht fertig ist.
+
+### Cherry-pick
+Kopiert einen ganz gezielten Commit von einem Branch in deinen aktuellen.
+
+```bash
+git cherry-pick <commit-hash>
+```
+
+**Wann?** Wenn ein Bugfix auf dem falschen Branch gelandet ist oder du nur eine einzige Funktion aus einem Feature-Branch brauchst.
+
+---
+
+## 🔄 Checkout & Switch
+
+```bash
+git checkout dev      # oder git switch dev – Wechselt zum Branch.
+git checkout -f dev   # Force Checkout: Wechselt den Branch und verwirft alle ungespeicherten lokalen Änderungen unwiderruflich! ⚠️
+```
+
+---
+
+## 💻 VS Code Git-Optionen (UI)
+
+VS Code bietet beim Branch-Wechsel oft drei intelligente Optionen an:
+
+* **Migrate Changes ⭐**
+	* Nimmt deine aktuellen Änderungen einfach mit in den neuen Branch.
+	* (Intern: stash → switch → stash pop).
+* **Stash & Checkout**
+	* Parkt deine Änderungen sicher im Stash und wechselt den Branch. Die Änderungen bleiben im Stash, bis du sie manuell wieder herausholst.
+* **Force Checkout ⚠️**
+	* Wechselt den Branch und löscht deine aktuellen, ungespeicherten Änderungen. Nur nutzen, wenn die Arbeit weggeworfen werden kann.
+
+---
+
+## 🔄 Typischer Sync-Workflow
+
+Um den Entwicklungs-Branch aktuell zu halten, nachdem dev in main gemerged wurde:
+
+1. Auf dev entwickeln.
+2. Merge dev → main für das Release.
+3. Zurück auf dev wechseln:
+		```bash
+		git checkout dev
+		git merge main   # (oder rebase), um den neuesten Stand vom Main wieder in Dev zu haben.
+		```
+
+---
+
+## 🧠 Merksätze
+
+* **Merge** = Historien verbinden (Sicher & Dokumentiert).
+* **Rebase** = Historie neu schreiben (Linear & Sauber).
+* **Stash** = "Ich parke das mal kurz hier."
+* **Migrate Changes** = Sicherer Branch-Wechsel mit "Gepäck".

manifest.json

@@ -2,20 +2,319 @@
   {
     "guid": "ef1e863f-cbb0-4e47-9f23-f0cbb1826ad4",
     "name": "Seasonals",
-    "description": "Adds seasonal effects like snow, leaves, etc. to the Jellyfin web interface.",
+    "description": "Adds atmospheric, animated seasonal effects like snow, falling leaves, hearts, fireworks and more. The plugin provides a settings page for configuration. If you do not have write permissions to the web folder, please also install the file-transformation plugin.",
-    "overview": "Seasonal effects for Jellyfin",
+    "overview": "Atmospheric, configurable seasonal effects for the Jellyfin web interface",
     "owner": "CodeDevMLH",
     "category": "General",
-    "imageUrl": "",
+    "imageUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/raw/branch/main/logo.png",
     "versions": [
+      {
+        "version": "1.6.13.5",
+        "changelog": "- Refactor seasonals.js",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.6.13.5/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "23beb3806fe9105dc01f793b46069808",
+        "timestamp": "2026-02-04T16:16:55Z"
+      },
+      {
+        "version": "1.5.1.0",
+        "changelog": "- fix: snowfall effect sometimes not scaling on window resize, which leads to clustering and rain effect of snowflakes",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.5.1.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "a66b5c24c1f4bfff14bba5e93576bb80",
+        "timestamp": "2026-01-28T22:40:49Z"
+      },
+      {
+        "version": "1.5.0.0",
+        "changelog": "- Refactor script injection logic",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.5.0.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "ba8d3c358df3e0546b99113b43f54fea",
+        "timestamp": "2026-01-08T23:31:52Z"
+      },
+      {
+        "version": "1.4.1.0",
+        "changelog": "- fix fireworks display issue on scroll",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.4.1.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "bd8d9c6af064de011a708ea85e9b08c0",
+        "timestamp": "2026-01-06T21:12:46Z"
+      },
+      {
+        "version": "1.4.0.0",
+        "changelog": "- settings linked directly in the main menu\n- renamed main plugin script\n- added enable/disable toggle for the entire plugin",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.4.0.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "205606075eec5f93d3da37efaecdeab5",
+        "timestamp": "2025-12-28T19:11:04Z"
+      },
+      {
+        "version": "1.3.4.0",
+        "changelog": "- some fixes for js loading\n- adapted config page descriptions",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.3.4.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "4869a9a0c08317d2cb0e0fc8f454cf2b",
+        "timestamp": "2025-12-24T02:02:15Z"
+      },
+      {
+        "version": "1.3.3.0",
+        "changelog": "- fixed: load config",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.3.3.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "9908c9357b2d8850e6349ce134bad2bd",
+        "timestamp": "2025-12-18T00:11:39Z"
+      },
+      {
+        "version": "1.3.0.0",
+        "changelog": "- fixed: image paths to ensure proper loading of resources.\n- fix: z-index issue to ensure seasonal effects appear above other UI elements.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.3.0.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "362fd94ab11f03e345a911a95d2d763b",
+        "timestamp": "2025-12-17T21:46:53Z"
+      },
+      {
+        "version": "1.2.0.0",
+        "changelog": "Advanced settings added: Users can now customize the intensity and speed of seasonal effects through the settings panel.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.2.0.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "5e18022c914c06072035dc0b4429e0fe",
+        "timestamp": "2025-12-17T20:59:37Z"
+      },
+      {
+        "version": "1.1.0.0",
+        "changelog": "Bug fixing: Fix path, fix injection issue, added File Transformator as fallback if direct injection is blocked due to permissions.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.1.0.0/Jellyfin.Plugin.Seasonals.zip",
+        "checksum": "be2e93364396b6e0e02368d5a7db53bc",
+        "timestamp": "2025-12-17T15:32:08Z"
+      },
       {
         "version": "1.0.0.0",
         "changelog": "Initial release",
         "targetAbi": "10.11.0.0",
-        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/raw/branch/main/bin/Publish/Jellyfin.Plugin.Seasonals.zip",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.0.0.0/Jellyfin.Plugin.Seasonals.zip",
         "checksum": "be6d06a959b3e18e5058a6d8fb6d800c",
         "timestamp": "2025-12-15T15:33:15Z"
       }
     ]
+  },
+  {
+    "guid": "d7e11d57-819b-4bdd-a88d-53c5f5560225",
+    "name": "Media Bar Enhanced",
+    "description": "A feature-rich fork of the original Media Bar script by MakD that brings your home screen to life.\n\n-> 100% Configurable via Web UI: Manage all features, lists, and settings effortlessly through the plugin configuration page.\n\nKey Highlights:\n- Cinematic Video Backdrops: Supports local & YouTube trailers (incl. SponsorBlock)\n- Custom Content: Curate your slideshow with specific Collections, Playlists, or seasonal events\n\nAdditional Features:\n- Full-width immersive mode\n- Smart resolution handling (up to 4K)\n- Full keyboard navigation & playback control\n- Wait-for-trailer options\n- Customizable pagination & animations\n\nIf you do not have write permissions to the web folder, please also install the file-transformation plugin.",
+    "overview": "Transforms your Jellyfin home screen with an immersive, fully configurable media slideshow featuring video backdrops.",
+    "owner": "CodeDevMLH",
+    "category": "General",
+    "imageUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/raw/branch/main/logo.png",
+    "versions": [
+      {
+        "version": "1.4.0.3",
+        "changelog": "- feat: Add client-side settings feature for selected media bar settings",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.4.0.3/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "9abf21c095e1ae99cdbeb51edb08f370",
+        "timestamp": "2026-02-04T15:52:11Z"
+      },
+      {
+        "version": "1.4.0.2",
+        "changelog": "- feat: Add client-side settings feature for selected media bar settings",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.4.0.2/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "6026fb8878a51f6dbe18aab1ac006df8",
+        "timestamp": "2026-02-04T15:45:39Z"
+      },
+      {
+        "version": "1.4.0.1",
+        "changelog": "- feat: Add client-side settings feature for selected media bar settings",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.4.0.1/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "4068c03b1ab809906d64d4faed1c1b0e",
+        "timestamp": "2026-02-04T15:01:50Z"
+      },
+      {
+        "version": "1.4.0.0",
+        "changelog": "- feat: Add client-side settings feature for selected media bar settings",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.4.0.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "20faa2a703dbb46591f4bd09e6ab7ec3",
+        "timestamp": "2026-02-04T12:49:45Z"
+      },
+      {
+        "version": "1.3.0.3",
+        "changelog": "- feat: Enhance custom media ID functionality with manual trailer override support",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.3.0.3/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "1d9e0a8342d46f84aed3f7bd1bee32d3",
+        "timestamp": "2026-02-04T01:41:35Z"
+      },
+      {
+        "version": "1.3.0.2",
+        "changelog": "- feat: Enhance custom media ID functionality with manual trailer override support",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.3.0.2/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "22e79daa5f433ca09a3db4f8e37679b4",
+        "timestamp": "2026-02-04T01:27:55Z"
+      },
+      {
+        "version": "1.3.0.1",
+        "changelog": "- feat: Enhance custom media ID functionality with manual trailer override support",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.3.0.1/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "5a4f555e29c733dabd51169f6ace56eb",
+        "timestamp": "2026-02-04T01:14:19Z"
+      },
+      {
+        "version": "1.3.0.0",
+        "changelog": "- feat: Enhance custom media ID functionality with manual trailer override support",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.3.0.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "83c26ba8f7ad6e1a7fe73c7190f532f3",
+        "timestamp": "2026-02-04T00:07:15Z"
+      },
+      {
+        "version": "1.2.3.7",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.\n- Update mediaBarEnhanced.js and mediaBarEnhanced.css with version 3.0.9 from original repo",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.7/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "fa1bf48cff159cc7dbf0aab48511a37c",
+        "timestamp": "2026-01-28T22:39:54Z"
+      },
+      {
+        "version": "1.2.3.6",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.6/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "da73bb490548c122906419d2762a2d00",
+        "timestamp": "2026-01-28T21:31:54Z"
+      },
+      {
+        "version": "1.2.3.5",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.5/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "b5efea79ec465522dad31e4ee5f1710c",
+        "timestamp": "2026-01-28T20:21:20Z"
+      },
+      {
+        "version": "1.2.3.4",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.4/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "4683f75e2df2590db663303bdd329ccd",
+        "timestamp": "2026-01-28T01:09:38Z"
+      },
+      {
+        "version": "1.2.3.3",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.3/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "3c18a84b2f59c86c130e91da83f980a2",
+        "timestamp": "2026-01-28T01:05:45Z"
+      },
+      {
+        "version": "1.2.3.2",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.2/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "4109a3ea10eb3145217b24ee8f8b37b5",
+        "timestamp": "2026-01-28T00:30:36Z"
+      },
+      {
+        "version": "1.2.3.1",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.1/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "e73029ac767e24d36742a27678758b6f",
+        "timestamp": "2026-01-28T00:17:28Z"
+      },
+      {
+        "version": "1.2.3.0",
+        "changelog": "- Fixes the issue where buttons were cut off on smaller screens such as on S24/S25.",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.3.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "ae6f34bee76f9d7873964a71ca191bf3",
+        "timestamp": "2026-01-27T23:54:42Z"
+      },
+      {
+        "version": "1.2.2.0",
+        "changelog": "- Fixes issues with persistent slides-container visibility",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.2.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "3362f93815845c4e85b66b31bcd0f52c",
+        "timestamp": "2026-01-24T22:53:55Z"
+      },
+      {
+        "version": "1.2.1.0",
+        "changelog": "- Update mediaBarEnhanced.js and mediaBarEnhanced.css with version 3.0.8 from original repo",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.1.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "70defc1fb29a17ff4c9362bf7bdc53b5",
+        "timestamp": "2026-01-22T23:50:56Z"
+      },
+      {
+        "version": "1.2.0.0",
+        "changelog": "- Add video quality preference setting (Auto / 1080p / Highres)\n- Set preferred video quality on YouTube player based on setting",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.2.0.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "0b6379f68990026240d97fe8f77fbef1",
+        "timestamp": "2026-01-08T23:30:58Z"
+      },
+      {
+        "version": "1.1.2.0",
+        "changelog": "- Add method to resume video playback when slideshow is active",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.1.2.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "a0e8ff5e59b22a1bdedc916cd5e1c16a",
+        "timestamp": "2026-01-08T15:26:55Z"
+      },
+      {
+        "version": "1.1.1.0",
+        "changelog": "- Add method to pause all video playback when navigating away from home screen",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.1.1.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "09da95fc561b11191d23a5cfa30ea731",
+        "timestamp": "2026-01-08T14:54:57Z"
+      },
+      {
+        "version": "1.1.0.0",
+        "changelog": "- 'custom media IDs' setting is now enabled by default (no input --> random selection)\n- improve GUID handling in slideshow manager to handle seperator and description",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.1.0.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "32305d72b8d704acf8eef0c22277fee9",
+        "timestamp": "2026-01-08T02:15:50Z"
+      },
+      {
+        "version": "1.0.0.3",
+        "changelog": "fixes",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.0.0.3/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "e6180c42836069029072e96ac4860c42",
+        "timestamp": "2026-01-06T23:26:29Z"
+      },
+      {
+        "version": "1.0.0.2",
+        "changelog": "fixes",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.0.0.2/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "1041b403ec0193c2172a6fe15501afd3",
+        "timestamp": "2026-01-06T21:21:37Z"
+      },
+      {
+        "version": "1.0.0.1",
+        "changelog": "fixes",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.0.0.1/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "f4e6194a9cc72fdda7436161c73832de",
+        "timestamp": "2026-01-06T21:18:33Z"
+      },
+      {
+        "version": "1.0.0.0",
+        "changelog": "Initial release",
+        "targetAbi": "10.11.0.0",
+        "sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/jellyfin-plugin-media-bar-enhanced/releases/download/v1.0.0.0/Jellyfin.Plugin.MediaBarEnhanced.zip",
+        "checksum": "2ba7cc7f238f6aa7097628797935b903",
+        "timestamp": "2026-01-06T18:56:30Z"
+      }
+    ]
   }
 ]