# SmartNotify - Jellyfin Plugin

**Intelligente Discord-Benachrichtigungen für Jellyfin 10.11+**

## Das Problem

Wenn du eine Serie gegen eine bessere Qualität austauschst, schreit Jellyfin "NEUE EPISODE!" - obwohl es nur ein Upgrade ist. Das nervt.

## Die Lösung

SmartNotify erkennt automatisch:
- **Wirklich neue Inhalte** → Benachrichtigung wird gesendet
- **Qualitäts-Upgrades** → Keine Benachrichtigung (oder optional eigener Typ)

Zusätzlich gruppiert SmartNotify Episoden intelligent:
- Statt 12 einzelner Nachrichten: **"Staffel 1: Episode 1-12 hinzugefügt"**
- Bei Lücken: **"Episode 1-4, 6, 8-12"**

## Features

- ✅ Erkennt Qualitäts-Upgrades automatisch
- ✅ Intelligente Episoden-Gruppierung  
- ✅ Unterstützt AniDB, AniList, TMDB, TVDB, IMDB
- ✅ Konfigurierbare Verzögerung (für Metadaten-Updates)
- ✅ Konfigurierbare Gruppierungsfenster
- ✅ Discord Webhook Support
- ✅ Deutsche Oberfläche

## Wie funktioniert die Erkennung?

SmartNotify führt eine lokale Datenbank mit allen bekannten Inhalten:

1. **Neues Item kommt rein**
2. SmartNotify generiert einen "Content Key" basierend auf:
   - Bei Episoden: Serie (Provider-IDs) + Staffel + Episode
   - Bei Filmen: Provider-IDs (AniDB, TMDB, etc.)
3. **Prüfung 1:** Existiert dieser Content Key schon in der DB? → Upgrade!
4. **Prüfung 2:** Gibt es gerade ein anderes Item mit gleichem Content Key? → Duplikat (neues File vor Löschung des alten)
5. Nur wenn beide Prüfungen negativ sind → Benachrichtigung

## Installation

## Manuelle Installation

1. Plugin von Releases herunterladen
2. ZIP entpacken in `plugins/SmartNotify/`
3. Jellyfin neustarten

## Konfiguration

Nach der Installation im Jellyfin Dashboard:
1. **Dashboard** → **Plugins** → **SmartNotify**
2. Discord Webhook URL eintragen
3. Server URL eintragen (für Bilder in Discord)
4. Optional: Verzögerung und Gruppierungsfenster anpassen

### Einstellungen

| Einstellung | Standard | Beschreibung |
|-------------|----------|--------------|
| Discord Webhook URL | - | Die Webhook-URL deines Discord-Kanals |
| Server URL | - | Öffentliche Jellyfin-URL (für Bilder) |
| Verzögerung | 5 min | Wartezeit für Metadaten-Updates |
| Gruppierungsfenster | 30 min | Zeitfenster für Episoden-Gruppierung |
| Upgrades unterdrücken | ✓ | Keine Benachrichtigung bei Ersetzungen |

## Beispiel-Benachrichtigungen

### Einzelne Episode
```
📺 Demon Slayer
Neue Episoden hinzugefügt:
Staffel 1: Episode 5
```

### Mehrere Episoden (gruppiert)
```
📺 Attack on Titan
Neue Episoden hinzugefügt:
Staffel 4: Episode 1-12
```

### Episoden mit Lücken
```
📺 One Piece
Neue Episoden hinzugefügt:
Staffel 1: Episode 1-4, 6, 8-12
```

### Film
```
🎬 Your Name (2016)
Kimi no Na wa - Ein Junge und ein Mädchen...
```

## Bekannte Einschränkungen

- Provider-IDs müssen vorhanden sein (AniDB, TMDB, etc.)
- Bei Items ohne Provider-IDs wird auf Name+Jahr zurückgefallen
- Die Datenbank wächst mit der Zeit (kann bei Bedarf gelöscht werden)

## Installation via Repository

In Jellyfin:
1. **Dashboard** → **Plugins** → **Repositories** → **+**
2. URL einfügen:
```
https://git.tdpi.dev/TDPI/jellyfin-plugin-smartnotify/raw/branch/main/manifest.json
```
3. **Katalog** → SmartNotify installieren
4. Jellyfin neustarten

## Lizenz

MIT