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ü "Info" / "Einzelupdate (Dateien und Module)". Beim Einzelupdate werden lokale Dateien nach Abgleich durch die entsprechenden Dateien im Github-Repo ersetzt. Bei der Auswahl der Dateien sollten noch nicht berücksichtigte Einzelupdates ebenfalls angewählt werden.
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:
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. Da dies für jeden Sender einzeln geschehen muss, dauert das Erstellen der Liste entsprechend länger.
Die zusätzlichen Menüs "EPG Alle JETZT" und "EPG Sender einzeln" funktionieren unabhängig von dieser Option.
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.
Diese Option holt die inhaltliche Beschreibung von allen Video einer Liste.
Dazu ermittelt das Addon 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.
Die Option steht nur in den Mediatheken ARD und ZDF und nicht in den Modulen zur Verfügung.
Beispiel ohne Inhaltstext:
Beispiel mit Inhaltstext:
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.