Compare commits
7 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
32e5e2b690 | ||
|
|
c967c1e308 | ||
|
|
ae28d5219b | ||
|
|
e4228f889e | ||
|
|
6d721c755e | ||
|
|
6948953778 | ||
|
|
8a50cef330 |
@@ -18,7 +18,7 @@
|
||||
<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>
|
||||
<span>${Help}</span>
|
||||
</a>
|
||||
</div>
|
||||
<hr style="max-width: 800px; margin: 1em 0;">
|
||||
@@ -69,8 +69,8 @@
|
||||
is="emby-checkbox" />
|
||||
<span>Allow Client-Side Toggle</span>
|
||||
</label>
|
||||
<div class="fieldDescription">If enabled, users will see a settings icon in the header to toggle
|
||||
animations for their browser.</div>
|
||||
<div class="fieldDescription">If enabled, users will see a seasonals icon in the header to toggle
|
||||
seasonals for their browser.</div>
|
||||
</div>
|
||||
<br>
|
||||
|
||||
|
||||
@@ -12,7 +12,7 @@
|
||||
<!-- <TreatWarningsAsErrors>false</TreatWarningsAsErrors> -->
|
||||
<Title>Jellyfin Seasonals Plugin</Title>
|
||||
<Authors>CodeDevMLH</Authors>
|
||||
<Version>1.6.12.0</Version>
|
||||
<Version>1.6.13.0</Version>
|
||||
<RepositoryUrl>https://github.com/CodeDevMLH/Jellyfin-Seasonals</RepositoryUrl>
|
||||
</PropertyGroup>
|
||||
|
||||
|
||||
@@ -298,7 +298,7 @@ function createSettingsPopup(anchorElement) {
|
||||
<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">Auto (Date Based)</option>
|
||||
<option value="auto">Server-Side</option>
|
||||
</select>
|
||||
</div>
|
||||
`;
|
||||
|
||||
188
README.md
188
README.md
@@ -13,20 +13,17 @@ This plugin is based on my manual mod (see the [legacy branch](https://github.co
|
||||
- [Table of Contents](#table-of-contents)
|
||||
- [Features](#features)
|
||||
- [Overview](#overview)
|
||||
- [Ideas for additional seasonals](#ideas-for-additional-seasonals)
|
||||
- [Installation](#installation)
|
||||
- [Client Compatibility](#client-compatibility)
|
||||
- [Configuration](#configuration)
|
||||
- [Automatic Theme Selection](#automatic-theme-selection)
|
||||
- [Theme Settings](#theme-settings)
|
||||
- [Build The Plugin By Yourself](#build-the-plugin-by-yourself)
|
||||
- [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)
|
||||
- [Legacy Manual Installation](#legacy-manual-installation)
|
||||
- [Installation](#installation-1)
|
||||
- [Usage](#usage)
|
||||
- [Additional Directory: Separate Single Seasonals](#additional-directory-separate-single-seasonals)
|
||||
|
||||
---
|
||||
|
||||
@@ -34,39 +31,83 @@ This plugin is based on my manual mod (see the [legacy branch](https://github.co
|
||||
|
||||
- **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**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Autumn</summary>
|
||||
|
||||
**Autumn**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Santa</summary>
|
||||
|
||||
**Santa**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Christmas</summary>
|
||||
|
||||
**Christmas**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Fireworks</summary>
|
||||
|
||||
**Fireworks**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Halloween</summary>
|
||||
|
||||
**Halloween**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Hearts</summary>
|
||||
|
||||
**Hearts**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Snowfall</summary>
|
||||
|
||||
**Snowfall**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Snowflakes</summary>
|
||||
|
||||
**Snowflakes**
|
||||
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>Snowstorm</summary>
|
||||
|
||||
**Snowstorm**
|
||||
|
||||
</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
|
||||
|
||||
@@ -135,7 +176,7 @@ If automatic selection is enabled, the following themes are applied based on the
|
||||
## 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
|
||||
## Build the plugin by yourself
|
||||
|
||||
If you want to build the plugin yourself:
|
||||
|
||||
@@ -203,116 +244,3 @@ volumes:
|
||||
|
||||
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/legacy/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>
|
||||
|
||||
@@ -26,8 +26,11 @@ git merge main
|
||||
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 rebase main
|
||||
git fetch origin
|
||||
git rebase origin/main
|
||||
git stash pop # (optional) Änderungen zurückholen.
|
||||
```
|
||||
|
||||
| Details | |
|
||||
@@ -38,6 +41,60 @@ git rebase main
|
||||
|
||||
---
|
||||
|
||||
## **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")
|
||||
|
||||
@@ -9,12 +9,12 @@
|
||||
"imageUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/raw/branch/main/logo.png",
|
||||
"versions": [
|
||||
{
|
||||
"version": "1.6.12.0",
|
||||
"version": "1.6.13.0",
|
||||
"changelog": "- feat: Add client-side toggle option for seasonal settings",
|
||||
"targetAbi": "10.11.0.0",
|
||||
"sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.6.12.0/Jellyfin.Plugin.Seasonals.zip",
|
||||
"checksum": "37adb35c6df14ba3d455dd2b7609cd83",
|
||||
"timestamp": "2026-02-03T21:28:05Z"
|
||||
"sourceUrl": "https://git.mahom03-spacecloud.de/CodeDevMLH/Jellyfin-Seasonals-Plugin/releases/download/v1.6.13.0/Jellyfin.Plugin.Seasonals.zip",
|
||||
"checksum": "171e02dc929fe93497e784e603475e50",
|
||||
"timestamp": "2026-02-03T23:12:28Z"
|
||||
},
|
||||
{
|
||||
"version": "1.5.1.0",
|
||||
|
||||
Reference in New Issue
Block a user