kodi

Konfiguration

Wichtig

Die Informationen zur Konfiguration des Plugins sind unter :doc:/plugins_doc/config/kodi beschrieben.

# etc/plugin.yaml
kodi:
    plugin_name: kodi
    host: 10.0.0.1
    #instance: kodi_one
    #autoreconnect: False
    #connect_retries: 10
    #connect_cycle: 5
    #command_repeat: 5
    #command_timeout: 5

Hinweise zu Verbindungen

Über die plugin-Parameter connect_retries und connect_cycle kann eingestellt werden, wie oft das Plugin versucht, eine Verbindung zu Kodi aufzubauen. Nach Ablauf dieser Versuche wartet das Plugin 30 Sekunden, bevor das Ganze wiederholt wird. Für diese Wiederholungen gibt es keine zeitliche Beschränkung, d.h. solange keine Verbindung besteht, versucht das Plugin alle 30 Sekunden erneut, die Verbindung mit den oben genannten Parametern herzustellen.

Items

kodi_item@[Instanz]: [Funktion]

Folgende Funktionen werden aktuell unterstützt: power Item type bool. Wird das Item auf „False“ gesetzt, wird Kodi heruntergefahren. Bei einem „True“ versucht das Plugin, eine Verbindung zu Kodi herzustellen (ohne Wake on LAN o.ä.)

volume Item type num. Einstellen der Lautstärke in Prozent, ein Wert zwischen 0 und 100.

speed Item type num. Einstellen der Abspielgeschwindigkeit. Muss einen gültigen geraden Wert enthalten, also +/- 1, 2, 4, 8, 16, 32. 1 ist Normalgeschwindigkeit.

seek Item type num. Zu einem bestimmten Punkt des aktuellen Mediums springen, in Prozent

mute Item type bool. Stummschalten.

player Item type num. Erhält automatisch die Player ID des aktuellen Players. Achtung: Ohne aktiven Player sind die Befehle Play, Pause, etc. nicht funktionsfähig.

title Item type str. Der Titel des aktuell gespielten Elements. Wird vom Plugin automatisch bei Änderungen aktualisiert.

media Item type str. Der Medientyp des aktuell gespielten Elements. Wird vom Plugin automatisch bei Änderungen aktualisiert.

macro Item type str. Eine Abfolge von Befehlen. Aktuell werden folgende Makros unterstützt, die beim Abspielen eines Elements relevant sind: - resume: Falls ein Medium eine gewisse Zeit gelaufen ist, ist es möglich, an der gleichen Stelle fortzusetzen. - beginning: Auch wenn ein Medium bereits eine gewisse Zeit gelaufen ist, wird von vorne begonnen.

state Item type str. Information zum aktuellen Status von Kodi (Playing, Stopped, Screensaver,…).

favourites Item type dict. Die in Kodi definierten Favoriten werden als Dictionary in dieses Item gespeichert. Ein Ändern der Einträge ist nicht möglich.

audio Item type foo. Ändern der Tonspur, entweder next, previous oder eine Zahl zur Direktanwahl

subtitle Item type list. Einstellen des Untertitels, entweder on, off, next, previous oder den Index der Untertitelspur. Das Anwählen einer Untertitelspur aktiviert automatisch die Anzeige.

streams Item type foo. Lieste die verfügbaren Audiospuren auf. Ein Ändern ist über die Funktion audio möglich.

subtitles Item type foo. Listet die verfügbaren Untertitelspuren auf. Ein Ändern ist über die Funktion subtitle möglich.

update Item type bool. Stößt beim Schreiben von True einmalig das Aktualisieren der Player- und Wiedergabeinformationen an.

stop Item type bool. Stoppt die Wiedergabe.

playpause Item type bool. Wechselt zwischen Wiedergabe und Pausenmodus.

goto Item type str. Ermöglicht Sprünge in der Wiedergabeliste mit next und previous als Wert.

quit Item type bool. Beendet Kodi, aber fährt den Rechner nicht herunter. Funktioniert nicht auf allen Installationen.

action Item type str. Diese Funktion ermöglicht die Kontrolle über Kodi wie mit einer Fernbedienung. Für dieses Item sollte enforce_updates aktiviert werden. Eine Übersicht über mögliche Aktion ist auf der Kodi Wiki Seite Ein Auszug der wichtigsten Aktionen:

  • play Abspielen. Es muss ein aktiver Player vorhanden sein!

  • pause Pausieren. Es muss ein aktiver Player vorhanden sein!

  • playpause Umschalten zwischen Abspielen und Pause. Es muss ein aktiver Player vorhanden sein!

  • stop Stoppen. Es muss ein aktiver Player vorhanden sein!

  • osd On Screen Display anzeigen

  • left Cursor nach links

  • right Cursor nach rechts

  • up Cursor nach oben

  • down Cursor nach unten

  • select Aktuelles Navigationselement aktivieren

  • contextmenu Anzeigen des Kontextmenüs

  • back Einen Schritt zurück

  • volumeup Erhöhen der Lautstärke

  • volumedown Verringern der Lautstärke

Struct Vorlagen

Ab smarthomeNG 1.6 können Vorlagen aus dem Plugin einfach eingebunden werden. Dabei stehen aktuell folgende Vorlagen zur Verfügung:

  • info: Enthält Funktionen, die zur Abfrage von Kodi Infos dienen.

  • control: Enthält Funktionen, mit denen Kodi gesteuert werden kann. Hier sind auch die wichtigsten input Befehle als eigene Items hinterlegt (play, pause, next, etc.)

  • examples: Vorlage-Struktur mit weiteren Beispielen