7. Zusätzliche Erweiterungen - streamxstream/plugin.video.xstream GitHub Wiki

7.1 TheMovieDB Helper

Der TMDB Helper ist ein Video-Addon mit dem man nach verschiedene Filmen und Serien suchen kann. Das Addon baut auf die API Schnittstelle von TMDb auf.

Somit werden alle Meta Informationen, wie zum Beispiel Darsteller, Veröffentlichungsdatum oder Trailer von Filmen oder Serien angezeigt. Eine genaue Beschreibung des Addons, Einstellungen und dessen Funktion sind hier zu finden. Informationen aus TMDb -, OMDb - und Trakt-APIs werden mit eigenen Benutzerdaten ebenfalls unterstützt. Das Video-Addon TheMovieDB Helper ist ein eigenständiges Addon und wird von dem Entwickler "jurialmunkey" stetig weiter entwickelt und steht in keinem Zusammenhang zu xStream.

7.1.1 Einstellungen im TheMovieDB Helper

In den Einstellungen solltet Ihr die nachfolgenden Elemente nach eurem belieben konfigurieren. Hier gehen wir kurz auf die wichtigsten Einstellungen kurz ein.

Nach der Installation die Einstellungen des Addons öffnen.

1. Allgemein

Bei "Sprache und Land" auf Deutsch (Deutschland) einstellen.

2. Bibliothek

Bei "Filme" gebt Ihr den Pfad der Bibliothek an. Der Standard Pfad der Kodi Bibliothek ist userdata\library\movies. Ihr könnt aber auch den vorgegebenen Pfad nutzen, was Ihr einstellt ist euch überlassen. Es funktionieren auch Netzwerkpfade NFS und SMB wenn Ihr eine NAS zum Beispiel nutzt. Bei "TV" gebt Ihr den Pfad der Bibliothek an. Der Standard Pfad der Kodi Bibliothek ist userdata\library\tvshows. Ihr könnt aber auch wieder den vorgegebenen Pfad nutzen, was Ihr einstellt ist auch hier wieder euch überlassen. Aktiviert die Option "Aktualisiere die Bibliothek nach dem Hinzufügen von Elementen". Ändert Ihr die Standardpfade dann aktiviert "Überprüfung der Ordnererstellung ignorieren"

3. Trakt

Wenn Ihr Trakt nutzen möchtet benötigt Ihr einen Account dafür. Diesen könnt Ihr dann in dem Punkt "Trakt authentifizieren" mit dem TheMovieDb Helper verbinden.

4. Abspieler

Hier könnt Ihr viel Einstellen was Ihr für richtig haltet. Wenn Ihr bestimmte Abspieler vordefiniert, werden diese automatisch genutzt. Bei "Abspieler von URL aktualisieren" könnt Ihr mit speziellen Links euch eure beliebten Player direkt installieren.

Eine TMDb Helper JSON Datei kann folgende Parameter enthalten:

• name: Name des Players
• plugin: plugin ID des abzuspielenden Programms
• priority: Priorität an welcher Stelle der Player in der Liste steht
• search_movie: Plugin Eintrag für Suche Filme + erweiterte Parameter
• search_episode: Plugin Eintrag für Suche Serie + erweiterte Parameter
• play_movie: Plugin Eintrag für Filme + erweiterte Parameter
• play_episode: Plugin Eintrag für Serien + erweiterte Parameter
• assert: Erweiterte Einträge
• fallback: Fallback Player wenn Datei nicht gefunden wird

7.1.2 xStream mit TheMovieDB Helper verbinden

Der "TheMovieDB Helper" bietet die Möglichkeit über verschiedene Player (wie z.B. xStream), lokale Videodateien und Streams verschiedener Webseiten abzuspielen. Wenn Ihr euch die xStream Player installiert, könnt Ihr die verschiedenen Webseite über die einzelnen Player Dateien ansprechen. Somit dient der TheMovieDB Helper als Schnittstelle für Filme und Serien der Kodi Bibliothek.

7.1.3 xStream TheMovieDB Helper Player

Die aktuellen xStream Player Dateien findet Ihr wie immer auf unserer Webseite zum Download oder den direkten Link zum einbinden in den "TheMovieDb Helper". Nach dem Download der Player ZIP-Datei, in den folgenden Pfad gehen:

userdata/addon_data/plugin.video.themoviedb.helper/players/

und den Inhalt der entpackten ZIP-Datei dort hinein kopieren. Oder Ihr nutzt unseren xStream Player Link von unserer Webseite und kopiert diesen in die TheMovieDb Helper Einstellungen. Diese Einstellung findet Ihr unter dem Reiter Abspieler, dort in die betreffende Zeile "Abspieler von URL aktualisieren" den Link einfügen. Dann die Aktualisierung starten und die Player installieren lassen.

Weitere Informationen zu den Player Dateien sind hier zu finden: Link

7.2 YouTube API Key

Um Videoinhalte von YouTube über externe Anwendungen abspielen zu können, benötigt Ihr einen eigenen API-Schlüssel von YouTube.

Die API-Schlüssel-ID wird von dem Google Cloud-Verwaltungstool verwendet, um den Schlüssel eindeutig zu identifizieren. Ihr benötigt 3 Teile um euch zu identifizieren. Die Client-ID den API-Schlüssel und den Client-Schlüssel.

7.1.1 YouTube API-Schlüssel und Anmeldedaten erstellen

Um YouTube Inhalte erfolgreich in Kodi ab zuspielen, benötigst du einen eigenen API-Schlüssel für dein YouTube Addon. Die Voraussetzung zur Erstellung eines API-Schlüssel ist ein aktives Google Konto. Wenn du kein Google Konto hast, kannst du dir eins einfach erstellen. Gehe hierfür auf die Google Account Seite und folge den Anweisungen. Alle anderen die schon ein aktives Google Konto besitzen können mit dem Link https://console.developers.google.com/projectcreate weiter verfahren.

Hier angekommen, vergewissere dich das du rechts oben mit dem richtigen Google Konto angemeldet bist. Gebt nun unter "Projektname" einen Namen für euer Projekt ein und bestätigt eure Eingabe anschließend in dem Ihr auf "Erstellen" klickt.

Im Dashboard angekommen, vergewissert euch ob links oben euer zuvor vergebenes Projekt auch ausgewählt ist, falls ihr mehrere Projekte habt. Klickt anschließend auf "Zur API-Übersicht"

Im nächsten Fenster müssen wir die API´s und Dienste für euer Projekt aktivieren. Klickt hierfür auf den Button "+ APIS UND DIENSTE AKTIVIEREN" und Ihr gelangt zur API Bibliothek.

In der API Bibliothek geben wir in das Suchfeld "YouTube" ein und bestätigen unsere Eingabe.

Es werden uns verschiedene Ergebnisse angezeigt. Wir benötigen für unser Projekt die "YouTube Data API v3" und bestätigen unsere Eingabe.

Im nächsten Fenster müssen wir unser ausgewähltes Produkt aktivieren. Klickt hierfür auf den "Aktivieren" Button damit das Produkt aktiviert wird.

Nach den wir das Produkt aktiviert haben, müssen wir noch unsere Anmeldedaten dafür erstellen. Hierfür klickt Ihr einfach auf "Anmeldedaten erstellen".

Wählt unter dem Bereich „Welche API verwenden Sie?“ das zuvor aktivierte Produkt aus „YouTube Data API v3“. Weiter geht es bei „Nutzerdaten“ dieser Punkt muss aktiviert werden. Habt Ihr alles klickt anschließend auf „Weiter“.

Im nächsten Fenster müssen wir die Anwendungsinformationen für die API anlegen. Gebt hier einen "Anwendungsname" ein. Unter „Nutzersupport-E-Mail“ stehen alle Google E-Mail-Adressen zur Verfügung, die mit dem entsprechenden Google Konto verknüpft sind, wählt eure entsprechende Adresse dort aus. Im Feld „Kontaktdaten des Entwicklers“ kann dieselbe oder eine andere E-Mail-Adresse eingetragen werden. Bestätigt eure Eingaben mit „Speichern und Fortfahren“.

Im nächsten Fenster "Bereiche" braucht Ihr nichts einzustellen oder anzugeben dieser Schritt kann einfach mit „Speichern und Fortfahren“ übersprungen werden.

Im nächsten Schritt müsst Ihr noch den "Anwendungstyp" einstellen. Wählt hier z.B. „Fernsehgerät und Geräte mit begrenzter Eingabe“ aus. Gebt bei Name noch einen Namen ein oder lasst es so stehen. Klickt nun auf "Erstellen" um eure Eingaben zu bestätigen.

Anschließend wird euch die Client-ID angezeigt. Öffnet euch einen Editor eurer Wahl und legt die kopierte Client-ID dort ab. Klickt auf "Fertig" um die restlichen Daten abzurufen.

Klickt im Seitenmenü auf "Anmeldedaten" dann auf "+ ANMELDEDATEN ERSTELLEN" und auf "API-Schlüssel. Es öffnet sich ein Popup worin Ihr mitgeteilt bekommt das euer API-Schlüssel erstellt wurde.

Kopiert euch wieder den API-Schlüssel und sichert auch diesen wieder in eurem Editor. Klickt dann auf "Schließen"

Klickt in dem Bereich „OAuth 2.0-Client-IDs“ auf den zuvor angelegten Namen der Anwendung. In diesem Fall wurde die Bezeichnung „TV-Client 1“ verwendet. Es öffnet sich ein weiteres Fenster. Hier erhaltet Ihr den Client-Schlüssel. Kopiert auch diesen Schlüssel und setzt Ihn in euren Editor. Klickt im Editor auf "Speichern unter" und gebt dort einen Namen und Pfad eurer Wahl an, um eure Daten zu sichern. Mit "Speichern" verlasst Ihr das Fenster.

Klickt im Seitenmenü auf "OAuth-Zustimmungsbildschirm". In diesem Fenster müsst Ihr eure zuvor eingerichtete Anwendung veröffentlichen. Klickt hierfür einfach auf "Anwendung veröffentlichen". Es erscheint ein Popup mit der Meldung "Push-Übertragung zu Produktion" klickt auf "Bestätigen" um den Vorgang abzuschließen. Im Veröffentlichungsstatus sollte jetzt "In Produktion" stehen. Nun seid Ihr fertig und habt alle benötigten Daten um euch im YouTube Addon zu identifizieren.

7.1.2 YouTube API-Schlüssel und Anmeldedaten in Kodi eintragen

Nach dem Ihr erfolgreich euren API-Schlüssel und eure Anmeldedaten erhalten habt, müsst Ihr diese nur noch in Kodi in das YouTube Addon eintragen. Hier zeigen wir Euch, wie Ihr das machen solltet. Im YouTube Addon weichen die Bezeichnungen etwas ab. Hier seht Ihr die Gegenüberstellung der Daten.

Erhaltene Daten	Im Kodi YouTube Addon
Mein API-Schlüssel	API-Schlüssel
Client-ID	API-Id
Client-Schlüssel	API-Geheimnis

Startet euer Kodi. Geht im Hauptmenü bei Addons auf YouTube und wählt im Kontextmenü "Einstellungen" aus.

Es öffnet sich die Einstellungsseite des YouTube Addons. Geht links im Reiter auf "API". Aktiviert den Punkt "Entwickler-Schlüssel erlauben".

Tragt hier unter API-Schlüssel den erhaltenen API-Schlüssel ein. Unter API-Id müsst Ihr eure Client-ID angeben und bei API-Geheimnis kommt der Client-Schlüssel rein. Habt Ihr alles eingetragen klickt Ihr auf "OK" um eure Einstellungen zu speichern. Nun könnt Ihr YouTube in Kodi verwenden.

7.1.3 YouTube mit Google Account nutzen und anmelden

Da Ihr nun ja ein Google Konto besitzt könnt Ihr dieses Konto auch mit dem YouTube Addon nutzen. Öffnet hierfür das YouTube Addon in Kodi.

Im Hauptmenü von YouTube klickt Ihr auf "Anmelden". Nun öffnet sich ein Popup worin Ihr euer Gerät Authentifizieren müsst. Das ganze müsst Ihr 2 mal durchführen. Öffnet mit einem zweit Gerät (Handy, PC oder Tablet) folgenden Link: https://google.com/device.

Gebt unter "Code eingeben" den Code aus dem Popup ein. Bestätigt eure Eingabe mit "Weiter" im nächsten Fenster klickt Ihr auf "Zulassen". Im YouTube Addon öffnet sich ein neues Popup worin euch der 2. Code angezeigt wird. Gebt auch diesen Code wieder auf eurem zweit Gerät ein und bestätigt auch diesen.

Nach erfolgreicher Bestätigung habt Ihr nun euren Account verknüpft und im YouTube Addon verschwindet der "Anmelden" Button.