01. Settings Allgemein
Skin-Hinweis: das Addon wurde mit und für den verbreiteten Kodi-Skin Estuary entwickelt. Die Darstellung in anderen Skins kann von den hier gezeigten Screenshots abweichen.
die Option ist unabhängig von den Kodi-Einstellungen in System/Logging. Es gibt keine Debug-Level - das Addon dokumentiert sehr ausführlich die verwendeten Funktionen, Funktionsparameter und Fehlermeldungen.
Da so die Logdatei sehr schnell anwächst, sollte die Debug-Option im Normalbetrieb ausgeschaltet bleiben.
Häufig reicht bei Fehlern eine Anfrage im Forum. Erst wenn hier keine Klärung möglich ist oder auf ausdrückliche Anforderung, sollte ein Logfile hochgeladen werden.
Das Logging erfolgt in der Logdatei von Kodi in dieser Form
"NOTICE: ARDundZDF --> addDir_label: 3Sat Mediathek"
Für die Fehlersuche zusammen mit dem Entwickler bieten u.a. diese Seiten hilfreiche Infos:
https://www.kodinerds.net/index.php/Thread/7121-Wo-finde-ich-das-log-File-von-Kodi-XBMC/
https://kodi.wiki/index.php?title=Log_file (engl., Hinweis auf http://paste.kodi.tv und https://paste.ubuntu.com)
In den allermeisten Fällen dürfte das Addon-Logging ausreichen. Das Anlegen der Datei advancedsettings.xml mit speziellen Debug-Einstellungen für Kodi kann auf Ausnahmefälle beschränkt bleiben (https://kodi.wiki/view/Advancedsettings.xml#Troubleshooting_settings).
Vorgehensweise bei der Fehlersuche mit Logfile:
- Kodi beenden und wieder neu starten (neues Logfile wird angelegt)
- Fehler produzieren
- eventuelles ähnliches aber funktionierendes Verhalten produzieren
- Logfile auf http://paste.kodi.tv/ hochladen
- Url dem Entwickler mit Fehlerbeschreibung mitteilen
Vorabinfo: das Updatemodul des Addons ist unabhängig vom Updatemechanismus in Kodi.
Ist die Option eingeschaltet, fragt das Addon beim Start beim Addon-Repository auf Github die Version des letzten Release ab. Ist die Version neuer als die eigene, schlägt das Addon vor: Update vorhanden - jetzt installieren. Entscheidet man sich nicht für den möglichen Abbruch sondern für das Update, wird das neue Addon von Github als ZIP-Datei geladen und damit das vorhandene Addon überschrieben. Die im Setting vorgenommenen Einstellungen bleiben dabei erhalten.
Ist die Option ausgeschaltet, kann trotzdem jederzeit über den Button Addon-Update im Hauptmenü nach neuen Updates gesucht werden.
Mit dem Einzelupdate können einzelne neue Bestandteile des Addons aktualisiert werden. Die Addon-Version ändert sich dabei nicht.
Anstehende Einzelupdates werden im Forum kodinerds im Startpost des Addons angezeigt. Dort finden sich auch Hinweise zu kurzfristig bereitgestellten Testaddons.
Erreichbar ist die Funktion über das Menü "Infos + Tools" / "Einzelupdate (Dateien und Module)". Beim Einzelupdate werden lokale Dateien nach Abgleich durch die entsprechenden Dateien im Github-Repo ersetzt.
Dabei hängt die Dauer des Abgleichs von der Anzahl der zu überprüfenden Dateien ab (Stand 13.10.2021: 20 Dateien, pro Datei mind. 1 Sec.). Es besteht daher die Möglichkeit, vor dem Einzelupdate eine eigene Auswahl vornehmen oder die komplette Liste abgleichen zu lassen. Die eigene Auswahl bietet sich an, falls nur eine oder wenige Dateien im Forum angezeigt wurden. Es empfiehlt sich aber, noch nicht berücksichtigte Einzelupdates ebenfalls anzuwählen, um neue Abhängigkeiten aufzulösen. Keine Sorge: die wiederholte Auswahl von Dateien ist völlig unschädlich.
Vor dem eigentlichen Abgleich ist noch ein Bestätigungsdialog "abzunicken":
Der Abgleich endet mit einer Ergebnisliste:
##3. Classic-Version der ARD Mediathek verwenden - entfällt ab Juni 2021
Diese Option schaltet zwischen den beiden Versionen der ARD-Mediathek (neue Mediathek: Modul ARDnew) um. Falls künftig die Classic-Version von der ARD eingestellt wird, entfällt die Option und der relevante Programmcode entfernt.
Die Einstellung ist auch relevant für die übergeordnete "Suche in ARD und ZDF". Ist die Classic-Version abgewählt, findet diese Suche in der neuen Mediathek der ARD statt.
Die Option stellt die Webseiten der 3Sat Mediathek (www.3sat.de) mit den Funktionen Suche, Livestream (mit Programmhinweis), Verpasst (Sendungen eines Monats), Sendungen A-Z|0-9 und Rubriken. zur Verfügung.
Weitere Module: Kinderprogramme, TagesschauXL, Phoenix, Arte-Kategorien
Die Option betrifft nur die TV-Live-Sender im Menü TV-Livestreams (Überregional, Regional und Privat):
Ist sie eingeschaltet, holt das Addon von tvtoday.de die Sendungen und ergänzt damit die Titel in der Senderliste.
Wegen der langen Ladezeit der EPG-Daten wird sehr empfohlen, die Hintergrundroutine zu nutzen - siehe EPG im Hintergrund laden (12 Std.-Intervall).
Senderliste ohne aktuelle Sendungen:
Senderliste mit aktuellen Sendungen:
Unabhängig von dieser Option ermöglicht das Kontextmenü eine EPG-Anzeige für den einzelnen Sender (aktueller Tag ab laufende Sendung):
Die zusätzlichen Menüs "EPG Alle JETZT" und "EPG Sender einzeln" funktionieren unabhängig von der Option EPG-Daten für TV-Live-Sender zeigen.
EPG Alle JETZT listet die TV-Live-Sender alphabetisch mit dem aktuellen Programmhinweis und Startzeit in der Titelzeile.
EPG Sender einzeln stellt zunächst die Senderliste zur Verfügung und listet dann für einen ausgewählten Sender die Programme für eine Woche, beginnend ab 05.00 Uhr des aktuellen Tages. Die laufende Sendung wird durch rote Schrift und den Hinweis "JETZT" hervorgehoben.
Verhalten unabhängig von der Option "EPG-Daten..":
- bei den Livestreams der Startseiten von ARD und ZDF werden keine Programmhinweise angezeigt
- dagegen werden Programmhinweise bei den Einzel-Livestreams angezeigt. Wo die Daten in den Quellen des Senders fehlen, werden sie von tvtoday.de geholt.
Häufig bieten die Sender in den Videolisten nur eine Kurzfassung des Inhalts. Diese Option holt die komplette inhaltliche Beschreibung von allen Video einer Liste (für einzelne Videos siehe unten Inhaltstext via Kontextmenü).
Bei ZDF-Beiträgen ermittelt das Addon dazu die Homepage jedes einzelnen Videos, extrahiert den Inhaltstext und speichert ihn im Addon-Cache (s. dort). Zusätzlich wird das Enddatum der Verfügbarkeit ermittelt. Je nach Umfang der Liste kann dies sehr lange dauern. Allerdings
entfällt die Wartezeit bei Wiederholungen, da die Texte dann aus dem Cache geladen werden. Ein Webzugriff ist nur für neu hinzugekommene Beiträge erforderlich.
Bei ARD-Beiträgen geht es schneller, da sich dort der Inhaltstext bei den Videoquellen zum Beitrag befindet. Diese Quellen lassen sich über eine spezielle Programmschnittstelle (API) wesentlich flotter laden als Webseiten.
Die Option steht nur in den Mediatheken ARD und ZDF und nicht in den Modulen zur Verfügung.
Beispiel ohne Inhaltstext:
Beispiel mit Inhaltstext:
Ab V5.1.2 steht für Videos der Eintrag Inhaltstext für Video zeigen zur Verfügung. Voraussetzung ist ein aktivierter Sofortstart - bei Einzelauflösungen entfällt dieser Eintrag. Für die Darstellung des Textes wird der Textviewer von Kodi verwendet.
Neben ARD und ZDF lassen sich hier auch Inhaltstexte von 3sat, phoenix, Kinderprogrammen (KiKA, ZDFtivi, ARD - Kinder und Familie) und TagesschauXL abrufen.
Die Position des Menüeintrags kann vom Bild abweichen. Sie hängt von den aktivierten Einstellungen ab.
Beispiel Kontextmenü:
Beispiel Inhaltstext im Textviewer (Seiten 1 - 3):
Diese Option ist dann auszuschalten, wenn zu einem Video die einzelnen Bandbreiten und Auflösungen gebraucht werden oder wenn Downloads gewünscht sind. Die Option wirkt auch bei TV-Livestreams und in den Modulen. Die Umschaltung ist auch im Kontextmenü möglich!
Beispiel für die Option Downloads (kann je nach Sender und Beitrag unterschiedlich ausfallen):
Diese Option sorgt dafür, dass die herunter geladenen Untertitel auch dargestellt werden (unabhängig von den Einstellungen in Kodi's Player Settings).
Die Einstellung ist im Wesentlichen nur für ZDF-Beiträge relevant, wo die Quellen für diese Videos extra ausgewertet werden müssen. Bei den barrierearmen Beiträgen der ARD spielt dies keine Rolle. Wenn das Addon dort z.B. das Menü "Videos mit Gebärdensprache" ansteuert, erhält es automatisch die dazu passenden Quellen in allen Auflösungen. Gleiches gilt für die ARD-Videos mit Untertiteln bzw. Audiodeskription.
Hiermit wird die Suche im stündlich aktualisierten Datenbestand von MediathekView ermöglicht.
Hinweise zu dieser Suchfunktion:
- bei Nutzung der Option stehen Suchbuttons sowohl im Hauptmenü als auch in den Modulen zur Verfügung. Das Addon passt den Suchbereich an den Menü-Kontext an
- die Senderliste (channel) von MediathekView weicht in einigen Fällen von der Liste im Addon ab. Daher erfolgt die Suche bei der ARD und beim ZDF unabhängig von dem jeweils eingestellten Sender. Das Addon markiert in den Ergebnislisten den Sender jeweils fett im Infotext
- bei der übergreifenden Suche im Hauptmenü wird im gesamten Bestand von MediathekView gesucht.
- bei den Modulen passt die Senderliste zum Addon - Ausnahmen: phoenix und TagesschauXL, wo jeweils im ARD-Bestand gesucht wird (der Infotext enthält Hinweise zum Suchbereich)
- Bilder zu den Videos fehlen - sie sind in den Suchergebnissen nicht enthalten
- laut bisherigen Tests stehen für gefundene Videos drei MP4-Quellen (low, med, hd) zur Verfügung
- die Quellen werden vollständig im Addon integriert und lassen sich wie gewohnt herunterladen (Sofortstart: AUS)
Beispiel für Suchergebnis:
Hinweis zu Modulen: Module wie z.B. 3sat lassen jederzeit an- und abwählen. Wie bei Modulbeiträgen in der Merkliste (s. Settings Favoriten / Merkliste), stellt das Addon sicher, dass auch bei abgewähltem Status ein Modul bis zur Rückkehr in das Hauptmenü des Addons nutzbar bleibt.