📺 Jellyfin MediathekViewDL Plugin

Ein leistungsstarkes Jellyfin-Plugin zum Suchen und Herunterladen von Inhalten aus den öffentlich-rechtlichen Mediatheken (ARD, ZDF, etc.).

Dieses Plugin integriert die MediathekViewWeb-API direkt in Jellyfin. Es ermöglicht das automatische Abonnieren von Sendungen, das intelligente Verwalten von Downloads und die nahtlose Integration in Ihre Medienbibliothek.

---

📑 Inhalt

• ✨ Features
• 🚀 Installation
• 🧙 Einrichtungs-Assistent
• ⚙️ Konfiguration & Nutzung
  • Manuelle Suche
  • Allgemeine Einstellungen
  • Abonnements (Automatische Downloads)
  • Downloads
  • Logs
• 🧠 Funktionsweise
• ❤️ Danksagung & Disclaimer

---

✨ Features

---

🚀 Installation

📦 Via Plugin Repository (Empfohlen)

Die einfachste Methode. Updates erfolgen automatisch über Jellyfin.

1. Öffnen Sie in Jellyfin: Dashboard -> Plugins -> Repositories.
2. Klicken Sie auf (+) Repository hinzufügen.
3. Tragen Sie folgenden Namen und URL ein:
   • Name: MediathekViewDL (oder beliebig)
   • Repository-URL:

     https://raw.githubusercontent.com/CatNoir2006/jellyfin-plugin-manifest/main/manifest.json
     

4. Installieren Sie das Plugin nun über den Katalog und starten Sie Jellyfin neu.

🛠️ Manuell (Für Entwickler)

🔽 Details

1. Repository klonen:

   git clone https://github.com/CatNoir2006/jellyfin-plugin-MediathekViewDL.git
   cd jellyfin-plugin-MediathekViewDL
   

2. Bauen:

   dotnet build
   

3. Installieren:
   • Erstellen Sie einen Ordner MediathekViewDL im plugins-Ordner Ihrer Jellyfin-Installation.
   • Kopieren Sie alle Dateien aus bin/Debug/net9.0 (oder Release) in diesen Ordner.
4. Neustart: Starten Sie den Jellyfin-Server neu.

---

🧙 Einrichtungs-Assistent

Bei einer Neuinstallation öffnet sich nach dem ersten Aufruf der Konfigurationsseite automatisch ein Einrichtungs-Assistent, der Sie in sieben kurzen Schritten durch die wichtigsten Einstellungen führt:

1. Willkommen – Kurze Einführung in das Plugin.
2. Standard-Pfade – Legen Sie fest, wo Serien, Filme und ggf. temporäre Downloads gespeichert werden.
3. Speicher sparen – Wählen Sie, ob neue Abos standardmäßig als .strm-Streamlinks statt als kompletter Videodatei gespeichert werden sollen (spart Speicher, benötigt aber Internet beim Abspielen).
4. Live-TV (optional) – Fügt den Zapp Tuner und/oder den Zapp Guide-Provider zur Jellyfin-Live-TV-Verwaltung hinzu.
5. Erstes Abo (optional) – Legt direkt ein erstes Abonnement mit Sender und Suchbegriff an.
6. Tab-Tour – Erklärt die fünf Tabs der Konfigurationsseite (Suche, Einstellungen, Abos, Downloads, Logs).
7. Fertig – Speichert den Status und schließt den Assistenten.

Den Assistenten können Sie jederzeit über die Schaltfläche 🧙 Einrichtungs-Assistent im Kopfbereich der Konfigurationsseite erneut starten – auch nachdem Sie ihn bereits abgeschlossen oder übersprungen haben. Der Status wird in der Plugin-Konfiguration (WizardCompleted) gespeichert.

---

⚙️ Konfiguration & Nutzung

Das Plugin fügt einen neuen Menüpunkt im Hauptmenü sowie eine Konfigurationsseite im Dashboard hinzu.

🔍 Manuelle Suche

Hier können Sie gezielt nach Sendungen suchen, Downloads sofort starten oder Suchfilter direkt in ein Abo umwandeln.

• Direkt-Download: Startet den Download sofort.
• In Abo übernehmen: Erstellt aus der aktuellen Suche ein dauerhaftes Abonnement.
• Ausschluss-Filter (NICHT): Durch Voranstellen eines Ausrufezeichens (z. B. !Wetter) können Begriffe von der Suche ausgeschlossen werden.

🔽 Erweiterter Download (Optionen)

Über "Erweiterter Download" können Pfad, Dateiname und Untertitel-Optionen individuell angepasst werden.

🛠 Allgemeine Einstellungen

(Tab: Einstellungen)

Hier konfigurieren Sie das globale Verhalten des Plugins. Die Einstellungen sind in logische Gruppen (Pfade, Download, Suche, Netzwerk, Abo-Standardwerte, Wartung) unterteilt.

🔽 Allgemeine Einstellungen (Bild)

📺 Abonnements (Automatische Downloads)

(Tab: Abo Verwaltung)

Das Herzstück des Plugins. Hier definieren Sie, was regelmäßig gesucht wird.

🔽 Abo-Editor Ansicht (Screenshot)

🔽 Klicken für Details zu allen Abo-Optionen (Tabelle)

Option	Beschreibung
Name	Der Name des Abos. Bestimmt den Unterordner für die Serie im Zielverzeichnis.
Virtuell (nur Kanal)	Markiert das Abo als virtuell. Es werden keine Dateien heruntergeladen und keine STRMs erstellt. Die Sendungen erscheinen stattdessen im Jellyfin-Kanal Mediathek (Virtual) und werden bei der Wiedergabe direkt aus der Mediathek gestreamt. Ideal, um Speicherplatz zu sparen und trotzdem bequem durch die Inhalte zu browsen.
Suchanfragen	Eine oder mehrere Suchkriterien (Titel, Thema, Sender). • Ausschluss (NOT): Klicken Sie auf die NOT-Schaltfläche im Abo-Editor, um einen Begriff auszuschließen (rot markiert). Ergebnisse mit diesem Begriff werden ignoriert.
Download-Pfad	Überschreibt den globalen Standard-Download-Pfad nur für dieses Abo.
Min. / Max. Dauer	Filtert Ergebnisse anhand der Dauer (in Minuten).
Min. / Max. Datum	Filtert Ergebnisse anhand des Sendedatums.
Nur Serien herunterladen	Lädt nur Inhalte, bei denen Staffel und Episode (SxxExx) erkannt wurden (EnforceSeriesParsing).
Absolute Nummerierung erlauben	Erlaubt Episoden wie "Episode 5" statt "S01E05". (Nur aktiv wenn "Nur Serien" aktiv).
Metadaten (.nfo) erstellen	Generiert NFO-Dateien mit Beschreibungen und Tags für Jellyfin/Kodi.
Originalsprache (ISO)	Setzt einen ISO-Sprachcode (z.B. 'eng'), wenn der Inhalt als Originalversion erkannt wird.
Streaming (.strm) verwenden	Speichert keine Videodatei, sondern nur eine Textdatei, die auf den Online-Stream verweist.
Vollständiges Video für sek. Audio	Lädt das komplette Video, auch wenn es eine andere Sprache als Deutsch hat (sonst nur Audio-Extrakt). (Nicht bei .strm).
Nicht-Episoden als Extras	Behandelt Videos ohne Episodennummer als Bonusmaterial.
↳ Trailer speichern	Speichert Trailer.
↳ Interviews speichern	Speichert Interviews.
↳ Generische Extras speichern	Speichert sonstige Extras.
↳ Extras als Stream (.strm)	Speichert Extras nur als Verknüpfung (spart Speicher).
Audiodeskription erlauben	Lädt auch Versionen mit Bildbeschreibung herunter.
Gebärdensprache erlauben	Lädt auch Versionen mit Gebärdensprache herunter.
Erweiterte Duplikaterkennung	Scannt das Zielverzeichnis physisch nach vorhandenen Dateien (SxxExx), um Doppelte zu vermeiden.
Fallback auf niedrigere Qualität	Erlaubt den Download schlechterer Qualität, wenn HD nicht verfügbar ist.
URL-Check vor Download	Prüft vorab, ob der Videolink erreichbar ist (vermeidet defekte Downloads, kostet Zeit). (Nur bei Fallback aktiv).
Datum/Uhrzeit im Titel	Hängt das Datum oder die Uhrzeit an den Titel an (ideal für News/Daily).
Abo prüfen (Dry Run)	Testet die Sucheinstellungen, ohne Dateien herunterzuladen.

📥 Downloads

(Tab: Downloads)

Behalten Sie den Überblick über laufende und vergangene Downloads.

• Aktive Downloads: Zeigt den aktuellen Fortschritt, Status und Geschwindigkeit. Laufende Downloads können hier abgebrochen werden.
• Historie: Eine Liste der erfolgreich abgeschlossenen Downloads.

📋 Logs

(Tab: Logs)

Zeigt die Server-Logs an, gefiltert auf Plugin-Einträge.

🔽 Logs Ansicht (Bild)

• Log-Datei Auswahl: Wählen Sie eine beliebige Log-Datei aus dem Dropdown (sortiert nach Änderungsdatum).
• Nur MediathekViewDL: Standardmäßig aktiv — filtert Einträge, die den Plugin-Namespace enthalten.
• Suche: Durchsuchen Sie die geladenen Einträge (case-insensitive). Mit der Regex-Checkbox können reguläre Ausdrücke verwendet werden.
• Auto-Scroll: Hält den automatischen Scroll nach unten beim Aktualisieren bei.
• Auto-Update (5s): Aktualisiert den Log-Inhalt alle 5 Sekunden automatisch.
• Kopieren: Kopiert alle sichtbaren (gefilterten) Einträge in die Zwischenablage.
• Doppelklick: Kopiert einen einzelnen Log-Eintrag (inkl. Stack-Trace) in die Zwischenablage.

---

❤️ Danksagung & Disclaimer

• Danke: Ein großer Dank geht an das Team von MediathekViewWeb.de für die Bereitstellung der API, ohne die dieses Plugin nicht möglich wäre.
• Disclaimer: Dieses Plugin dient der Automatisierung des Zugriffs auf öffentlich verfügbare Inhalte. Bitte beachten Sie die Nutzungsbedingungen der jeweiligen Sender und Mediatheken. Die Nutzung erfolgt auf eigene Gefahr.

---

Letze Anpassung der Readme

• Plugin: v0.8.0.3