{"id":43711325,"url":"https://github.com/mediathekview/plugin.video.mediathekview","last_synced_at":"2026-02-05T06:33:38.379Z","repository":{"id":28111066,"uuid":"116314132","full_name":"mediathekview/plugin.video.mediathekview","owner":"mediathekview","description":"Kodi plugin that gives access to most video-platforms from German public service broadcasters using the database of MediathekView.de","archived":false,"fork":false,"pushed_at":"2024-06-02T14:28:54.000Z","size":15737,"stargazers_count":54,"open_issues_count":3,"forks_count":24,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-06-02T15:47:02.568Z","etag":null,"topics":["kodi","kodi-addon","plugin"],"latest_commit_sha":null,"homepage":"https://mediathekview.de/download/#mediathekview-f%C3%BCr-kodi-fr%C3%BCher-xbmc","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mediathekview.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-04T22:32:43.000Z","updated_at":"2024-06-02T14:28:57.000Z","dependencies_parsed_at":"2024-05-17T18:03:09.084Z","dependency_job_id":null,"html_url":"https://github.com/mediathekview/plugin.video.mediathekview","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"purl":"pkg:github/mediathekview/plugin.video.mediathekview","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediathekview%2Fplugin.video.mediathekview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediathekview%2Fplugin.video.mediathekview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediathekview%2Fplugin.video.mediathekview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediathekview%2Fplugin.video.mediathekview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mediathekview","download_url":"https://codeload.github.com/mediathekview/plugin.video.mediathekview/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mediathekview%2Fplugin.video.mediathekview/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29114910,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T05:31:32.482Z","status":"ssl_error","status_checked_at":"2026-02-05T05:31:29.075Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["kodi","kodi-addon","plugin"],"created_at":"2026-02-05T06:33:38.319Z","updated_at":"2026-02-05T06:33:38.370Z","avatar_url":"https://github.com/mediathekview.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Kodi MediathekView.de Addon\n===========================\n\n* **English Version:** Please see below\n* **Versione Italiana:** Il testo italiano si trova più in basso\n\n[1]: https://forum.mediathekview.de/category/14/offizieller-client-kodi-add-on\n[2]: https://forum.kodi.tv/showthread.php?tid=326799\n[3]: https://github.com/mediathekview/plugin.video.mediathekview/issues\n[4]: https://github.com/mediathekview/plugin.video.mediathekview\n[5]: https://github.com/mediathekview/kodi-repos\n\nÜber dieses Addon\n-----------------\n\nUnd schon wieder ein Kodi-Addon für deutsche Mediatheken... Wozu das ganze?\n\nWeil der Ansatz dieses Addons ein anderer ist, als der der bereits verfügbaren\nAddons: dieses Addon benutzt die Datenbank des beliebten Projektes\n\"MediathekView\", welche stündlich aktualisiert wird und über 200.000 Einträge\naus allen deutschen Mediatheken enthält. Dieser Ansatz hat einige entscheidende\nVorteile gegenüber den anderen Addons, die in der Regel die sich stetig\nverändernden Webseiten der Mediatheken der Öffentlich Rechtlichen durchsuchen.\n\n* Hohe Geschwindigkeit beim Durchsuchen und Navigieren\n* Unabhängigkeit von allen Änderungen des Seitenlayouts der Mediatheken\n* Hohe Zuverlässigkeit\n\n\nFür Fragen und Anregungen zu diesem Addon steht das [deutschsprachige Forum][1]\nzur Verfügung. Fehlermeldungen und Vorschläge für neue Features können auch\ndirekt als [GitHub Issue][3] gemeldet werden. Der Quelltext steht ebenfalls auf \n[GitHub][4] zur Verfügung.\n\n\nWichtigste Features\n-------------------\n* Hintergrundaktualisierung der Datenbank\n* Blitzschnelle Navigation\n* Herunterladen von Filmen mit automatischer Erzeugung von NFO Dateien und\n  eventueller Untertitel\n* Lokale interne Datenbank oder geteilte MySQL Datenbank\n* Benutzeroberfläche verfügbar in Deutsch, Englisch und Italienisch\n\n\nFunktionsweise\n--------------\n\nDas Addon lädt die Datenbank von MediathekView herunter und importiert diese\nentweder in eine lokale SQLite Datenbank, oder wahlweise in eine lokale\noder entfernte MySQL Datenbank (zur Benutzung durch mehrere Kodi-Clients).\nWährend der Laufzeit von Kodi werden in einem konfigurierbaren Intervall\n(Standard: 2 Stunden) die Differenzdateien von MediathekView heruntergeladen\nund in die Datenbank integriert. Spätestens am nächsten Kalendertag nach\ndem letzten Update wird die Aktualisierung wieder mittels des vollständigen\nUpdates von Mediathekview ausgeführt.\n\n\nSystemvoraussetzungen\n---------------------\n\nDie Systemvoraussetzungen für das Addon unterscheiden sich je nach\nKonfiguration. Nach der Installation startet das Addon im lokalen Modus:\ndies bedeutet, dass eine lokale SQLite-Datenbank benutzt wird, die auch\ndurch das Kodi-System lokal aktualisiert wird. Dies dürfte auch das\nüblichste Szenario sein.\n\nDie Benutzung der lokalen Datenbank erfordert im Idealfall ein einigermaßen\nperformantes Dateisystem. Ein Raspberry mit seiner langsamen SD-Karte ist in\ndiesem Fall sicherlich nicht die allerbeste Wahl. Das vollständige Update der\nDatenbank dauert auf einem solchen System erfahrungsgemäß um die 15-20 Minuten.\nDa dies aber im Hintergrund passiert, kann man unter Umständen gut damit leben.\n\nDas Addon wurde auf verschiedenen Plattformen unter Linux, MacOS, Windows und\nLibreELEC bzw. OpenELEC getestet. Auch verschiedene Android Systeme konnten\nschon erfolgreich getestet werden. Wegen der Vielzahl der Plattformen ist es\nallerdings nicht möglich eine abschließende Kompatibilitätsaussage zu machen.\n\n\nInstallation\n---------------------\n\nDas Mediathekviewplugin kann für Kodi (17-20) aus eigens dafür\nangelegten Repositories bezogen werden. So können stable releases oder auch Beta-Versionen\nautomatisch bezogen werden.\n\nEin ausführliche Beschreibung zur Installation und die ZIP-Dateien sind im [Mediathekview GITHUB Repository][5] abgelegt.\n\nBeim bauen aus GITHUB, muss man die addon.xml entsprechend anpassen (Kodi 17 \u0026\nKodi 18 \u003e addon.kodi18.xml / Kodi 19 \u0026 Kodi 20 \u003e addon.kodi19.xml). Dies ist aber nicht empfohlen,\nda so Updates und Fixes von Hand installiert werden müssen.\n\n**Anmerkung**:\nDa das Mediathekviewplugin nicht mehr über das offizielle Kodi Repository\nangeboten und muss über das eigene Mediathek Repo installiert werden.\n\n\n\nFunktionsweise der Aktualisierungsmethoden\n------------------------------------------\n\nDas Addon unterstützt 5 verschiedene Aktualisierungsmethoden:\n* **Zeitgesteuert:** Bei dieser Methode erfolgt die Aktualisierung ein mal\npro eingestelltem Zeitintervall (Standard: 2 Stunden). Die erste\nAktualisierung eines Kalendertages ist eine vollständige Aktualisierung, alle\nweiteren sind Differenz-Aktualisierungen.\n* **Automatisch (Standard):** Bei dieser Methode wird die Aktualisierung der\nDatenbank automatisch durchgeführt. Die Aktualisierung erfolgt ein mal pro\neingestelltem Aktualisierungsintervall (Standard: 2 Stunden). Die erste\nAktualisierung eines Kalendertages ist eine vollständige Aktualisierung, alle\nweiteren sind Differenz-Aktualisierungen. Die automatische Aktualisierung\npausiert, wenn das Addon länger als 2 Stunden nicht bedient wurde, um\nBandbreite und bei mobilen Geräten Strom zu sparen.\n* **Nur beim Start:** Eine Aktualisierung erfolgt nur beim Start des Addons.\nHandelt es sich hierbei um die erste Aktualisierung des Kalendertages, ist\ndies eine vollständige Aktualisierung, ansonsten eine differentielle. Alle\nweiteren Aktualisierungen müssen manuell über das Hauptmenü vom Benutzer\nausgelöst werden.\n* **Manuell:** Es erfolgt keine automatische Aktualisierung. Der Benutzer\nhat die Möglichkeit Aktualisierungen über das Hauptmenü auszulösen. Handelt\nes sich hierbei um die erste Aktualisierung des Kalendertages, ist dies eine\nvollständige Aktualisierung, ansonsten eine differentielle.\n* **Abgeschaltet:** Es erfolgt keine automatische Aktualisierung. Diese\nKonfiguration ist nur dann sinnvoll, wenn das Plugin eine externe Datenbank\nnutzt und diese anderweitig aktualisiert wird.\n\n\nAlternativ-Konfigurationen\n--------------------------\n\nIst das Kodi-System zu langsam um eine eigene Datenbank zu verwalten\n(z.B. Raspberry PI mit sehr langsamer SD-Karte) oder soll die Datenbank mit\nmehreren Kodi Systemen geteilt werden, so besteht die Möglichkeit das Addon\nauch mit einem externen Datenbank-Server (MySQL oder MariaDB) zu nutzen.\n\nDa viele Kodi-Nutzer über ein eigenes NAS-System verfügen um ihre Medien\ndem Media-Center zur Verfügung zu stellen, eignet sich dieses in der Regel\nauch als MySQL bzw. MariaDB Datenbank-Server da nahezu alle NAS-Betriebssysteme\ndie Installation eines solchen anbieten.\n\nIst das Addon so konfiguriert, dass eine MySQL/MariaDB Datenbank genutzt werden\nsoll, erzeugt dieses die Datenbank selbsttätig, falls diese auf dem\nDatenbankserver noch nicht existiert. Der angegebene Datenbankbenutzer muss\ndafür allerdings auch die Rechte dafür besitzen.\n\nDie Verbindung zur Datenbank kann in den Addon-Einstellungen im Abschnitt\n_\"Datenbank Einstellungen\"_ vorgenommen werden.\n\nIst mindestens eines der angeschlossenen Kodi-Systeme in der Lage das Update\nder Datenbank durchzuführen, so ist für das Update gesorgt. Sollte dies nicht\nder Fall sein, so besteht auch die Möglichkeit, den Update-Prozess auf einem\nanderen System (z.B. das NAS, den Datenbankserver oder eine andere Maschine)\nlaufen zu lassen.\n\n\nStandalone Datenbank Update Prozess\n-----------------------------------\n\nUm die Datenbankaktualisierung von der Kommandozeile auszuführen, muss das\nZielsystem einen python-Interpreter bereitstellen. Des weiteren müssen noch\nfolgende Bibliotheken zur Verfügung stehen, sowie das Entpackprogramm\n'xz' (optional):\n\n* mysql-connector\n\nDie Installation dieser Bibliotheken unter Debian/Ubuntu erfolgt durch Eingabe folgender Befehle:\n\n````\nPython 2:\nsudo apt install python-pip\npip install mysql-connector-python\nPython 3:\nsudo apt install python3-pip\npip3 install mysql-connector-python\n````\n\nDas Aktualisierungsprogramm heisst `mvupdate` (`mvupdate3` für Python 3) und liegt im Hauptverzeichnis\ndes Addons und muss auch von dort ausgeführt werden. Aus diesem Grunde muss\ndas Addon in einem Verzeichnis aus der ausführenden Maschine kopiert werden.\n\nDies kann entweder durch Herunterladen und Entpacken der Addon-ZIP-Datei\nerfolgen oder durch Klonen des Addon-Quellcode-Repositories mittels `git`\n\n````\ngit clone https://github.com/mediathekview/plugin.video.mediathekview.git\n````\n\nDurch Angabe des Parameters `-h` bzw. `-h` hinter dem Datenbanktyp, gibt\ndas Programm spezifische Hilfe aus. Beispiel:\n\n````\nleo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h\nusage: mvupdate mysql [-h] [-v] [-f | -F] [-i INTERVALL] [-H HOST] [-P PORT]\n                      [-u USER] [-p PASSWORD] [-d DATABASE]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v, --verbose         show progress messages (default: 0)\n  -f, --force           ignore the minimum interval (default: False)\n  -F, --full            ignore the minimum interval and force a full update\n                        (default: False)\n  -i INTERVALL, --intervall INTERVALL\n                        minimum interval between updates (default: 3600)\n  -H HOST, --host HOST  hostname or ip address (default: localhost)\n  -P PORT, --port PORT  connection port (default: 3306)\n  -u USER, --user USER  connection username (default: mediathekview)\n  -p PASSWORD, --password PASSWORD\n                        connection password (default: None)\n  -d DATABASE, --database DATABASE\n                        database name (default: mediathekview)\n````\n\n\nDocker Container (mit interner MYSQL Datenbank)\n-----------------------------------------------\nDie Standalone Datenbank inkl. regelmäßiger Aktualisierung (Cronjob) über `mvupdate3` kann in einem Docker Container gehalten werden. Das Image basiert auf auf dem mariadb Container von linuxserver.io (siehe https://docs.linuxserver.io/images/docker-mariadb).\n\n\n**Container bauen:**\n\nZunächst muss das Repository als zip heruntergeladen und enpackt oder via git clone auf den Rechner mit installierten docker gebracht werden. Dann im Verzeichnis `plugin.video.mediathekview` das Container Image erstellen:\n\n````\ndocker build --no-cache -t mediathekview-kodi-db .\n````\n\n\n**Container Konfiguration:**\n\n| Umgebungsvariable   | Standard Wert       | Erklärung       |\n| -----------------   | --------------      | --------------- |\n| PUID                | 1000                | für UserID; siehe auch Erklärung auf linuxserver.io| \n| GUID                | 1000                | für GroupID; siehe auch Erklärung auf linuxserver.io| \n| TZ                  | Europe/London       | verwendete Zeitzone im Container |\n| MYSQL_DATABASE      | mediathekview       | Name der MYSQL Datenbank; diese Datenbank wird beim ersten Starten des Containers angelegt|\n| MYSQL_USER          | mediathekview       | Superuser-Benutzer der o.g. MYSQLS Datenbank|\n| MYSQL_PASSWORD      | mediathekview       | Passwort für MYSQL_USER (minimum 4 Zeichen); sollte in ein sicheres Passwort geändert werden |\n| MYSQL_ROOT_PASSWORD | mediathekview_root  | Root Passwort für die MYSQL Datenbank (minimal 4 Zeichen); sollte in ein sicheres Passwort geändert werden|\n| CRON_TIMESPEC       | 0 4-22/1 * * *      | Zeitausdruck im Cron-Format, der angibt wann die Datenbank per `mvupdate3` aktualisiert werden soll (Default: zu jeder vollen Stunde zwischen 4 und 22 Uhr). Ein Generator für diese Ausdrücke findet sich bspw. hier: https://crontab.guru/| \n| RUN_ON_STARTUP      | no\t\t    | wenn 'yes', dann wird `mvupdate3` bei starten des Containers ausgeführt\n\n\nUm mit Kodi auf die Datenbank zugreifen zu können, muss der `Port 3306` nach außen geleitet werden. Bei mehereren Containern mit MYSQL Datenbank empfiehlt es sich den MYSQL-Port 3306 auf einen freien Port umzuleiten (z.B.: `-p 49153:3306`). *Achtung:* Innerhalb des Containers gilt weiterhin der Port 3306 (z.B. für den Aufruf von `mvupdate3`). Außerhalb bzw. in Kodi muss dann der konfigurierte Port (im Beispiel 49153) verwendet werden.\n\nDie Datenbank selbst sowie weitere Konfigurationsdaten werden im Ordner `/config` gespeichert. Dieser ist als Docker-Volume konfiguriert (`-v path_to_data:/config`) und seine Daten bleiben auch beim Neuaufsetzen des Containers erhalten.\n\n\n**Container Starten (Beispielkonfiguration):**\n````\ndocker run -d \\\n  --name mediathekview-kodi-db \\\n  -e PUID=1000 \\\n  -e GUID=1000 \\\n  -e TZ='Europe/Berlin' \\\n  -e MYSQL_DATABASE='mediathekview' \\\n  -e MYSQL_USER='mediathekview' \\\n  -e MYSQL_PASSWORD='mediathekview' \\\n  -e MYSQL_ROOT_PASSWORD='mediathekview_root' \\\n  -e CRON_TIMESPEC='0 4-22/1 * * *' \\\n  -p 3306:3306 \\\n  -v path_to_data:/config \\\n   mediathekview-kodi-db\n````\n\n\n**Hinweise:**\n* In der Powershell werden mehrzeilige Befehle mit ` (Backtickle) dargestellt\n* Je nach GIT Einstellung werden Dateien mit Windows LN ausgecheckt. Ggf. müssen die Scripte geprüft werden.\n* Die Log-Ausgabe von `mvupdate3` wird im Docker-Log teilweise erst nach Abschluss der Aktualisierung angezeigt.\n* Um Speicherplatz zu sparen kann das binlog der maria-db abgeschaltet werden. Dazu in `/config/custom.cnf` die Zeile `log_bin = /config/log/mysql/mariadb-bin` durch `skip-log-bin` ersetzen. Weitere Informationen zum Thema binlog gibt es [hier](https://mariadb.com/kb/en/binary-log/).\n\n\nEnglish Version\n===============\n\nAbout this Addon\n----------------\n\nYet another Kodi Addon for the German public service video platforms... Why?\n\nBecause the approach of this addon is different from that of the already\navailable addons: this addon uses the database of the popular project\n_\"MediathekView\"_, which is updated hourly and contains more than 200,000\nentries from all German public service video platforms. This approach has\nsome significant advantages over the other add-ons that usually scan the\never-changing websites of the German public service video platforms:\n\n* High speed browsing and navigation\n* Independence from all changes to the page layout of the media libraries\n* High reliability\n\nIf you have any questions or suggestions about this addon, please feel free\nto use the [official Kodi Addon Forum topic][2] or the [German forum topic][1].\nErrors and feature requests can also be reported directly as [GitHub Issue][3].\nThe source code is available as well on [GitHub][4].\n\n\nHighlights\n----------\n* Background updating of the database\n* Amazing fast navigation and search\n* Download with subtitles and automatic NFO file generation\n* Internal standalone or shared MySQL database support\n* UI localised to German, English and Italian\n\n\nHow it Works\n------------\n\nThe addon downloads the database from MediathekView and imports it either into\na local SQLite database, or alternatively into a local or remote MySQL database\n(for use by multiple Kodi clients).\nDuring the runtime of Kodi, only the differential update files are downloaded\nfrom MediathekView in a configurable interval (default: 2 hours) and integrated\ninto the database. By the next calendar day after the last update at the latest,\nthe update will be carried out again by importing the full MediathekView\ndatabase.\n\n\nSystem Requirements\n-------------------\n\nThe system requirements for the addon vary depending on the configuration.\nAfter installation, the addon starts in local mode: this means that a local\nSQLite database is used, which is also updated locally by the Kodi system.\nThis is probably the most common scenario.\n\nIdeally, using the local database requires a file system with a decent\nperformance. A Raspberry with a slow SD card is certainly not the very\nbest choice in this case but still acceptable. The full update will take\nin this case about 15-20 Minutes but since this happens in the background,\nyou may be able to live with it.\n\nThe addon has been tested on different platforms under Linux, MacOS,\nWindows and LibreELEC/OpenELEC. Various Android systems have also been\ntested successfully. Due to the variety of platforms, however, it is not\npossible to make a final compatibility statement.\n\n\nInstall\n-------------------\n\nThe Mediathekview plug-in can be used for Kodi (17-20). There are\nindividual repositories for stable releases and beta-versions.\n\nPlease check the [GITHUB Repository][5] for further details and repository ZIP-Files.\n\nWhen building from GITHUB, you have to adapt the addon.xml accordingly (Kodi 17 \u0026\nKodi 18\u003e addon.kodi18.xml / Kodi 19 \u0026 Kodi 20\u003e addon.kodi19.xml). This is not recommanded,\nsince you will need to install updates and fixes on your own.\n\n**Note**:\nSince the Mediathekview plug-in no longer available on the official Kodi Repository\n, it must be installed from the Mediathek Repository.\n\n\nHow the update methods work\n---------------------------\n\nThe addon supports 5 different update methods:\n* **Continously:** This method automatically updates the database. The update\ntakes place once per set update interval (default: 2 hours). The first update\nof a calendar day is a full update, all others are differential updates.\n* **Automatic (Default):** This method automatically updates the database.\nThe update takes place once per set update interval (default: 2 hours). The\nfirst update of a calendar day is a full update, all others are differential\nupdates. The auto-update pauses if the addon has not been used for more than\n2 hours to save bandwidth and power on mobile devices.\n* **On Start:** An update will only take place on the first invocation of the\naddon during the Kodi runtime. If this is the first update of the day, it is a\ncomplete update, otherwise a differential one. All further updates must be\nmanually initiated by the user via the main menu.\n* **Manual:** There is no automatic update. The user has the possibility to\ninitiate updates via the main menu. If this is the first update of the day,\nit is a complete update, otherwise a differential one.\n* **Disabled:** There is no automatic update. This configuration only makes\nsense if the plugin uses an external database and this database is updated\nelsewhere.\n\n\nAlternate Configurations\n------------------------\n\nIf the Kodi system is too slow to manage its own database (e.g. Raspberry PI\nwith a very slow SD card) or you want to share the database across multiple\nKodi instances, it is also possible to use the addon with an external database\n(MySQL or MariaDB).\n\nSince many Kodi users have their own NAS system to make their media available\nto the media center, this is usually also suitable as a MySQL/MariaDB database\nserver since almost all NAS operating systems offer the installation of MySQL.\n\nIf the addon is configured to use a MySQL/MariaDB database, the database is\ncreated automatically if it does not yet exist on the database server. However,\nthe specified database user must also have sufficient user rights in order to\ndo this.\n\nThe connection to the database can be configured in the addon settings in\nthe \"Database Settings\" section.\n\nIf at least one of the connected Kodi systems is able to update the database,\nthe data is available to all Kodi systems. If this is not the case, it is\nalso possible to run the update process on a different system (e.g. the NAS,\nthe database server or another machine).\n\nStandalone Database Update Process\n----------------------------------\n\nA python interpreter as well as the unpacker 'xz' is requirered on the\ntarget system in order to execute the commandline update process. Additionally\nthe following python library is required:\n\n* mysql-connector\n\nThe required library can be installed via pip:\n\n````\nPython 2:\nsudo apt install python-pip\npip install mysql-connector-python\nPython 3:\nsudo apt install python3-pip\npip3 install mysql-connector-python\n````\n\nThe update program is called `mvupdate` (`mvupdate3` for Python 3) and is located in the root directory\nof the addon and must be executed from there. The whole addon has to be copied\nto the target machine.\n\nThis can be either done by downloading and unpacking the addon archive or\nby cloning the source repository with `git`\n\n````\ngit clone https://github.com/mediathekview/plugin.video.mediathekview.git\n````\n\nBy specifying the option `-h` itself or after the requested database type,\nthe application shows specific help instructions:\n\n````\nleo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h\nusage: mvupdate mysql [-h] [-H HOST] [-P PORT] [-u USER] [-p PASSWORD]\n                      [-d DATABASE]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v, --verbose         show progress messages (default: 0)\n  -f, --force           ignore the minimum interval (default: False)\n  -F, --full            ignore the minimum interval and force a full update\n                        (default: False)\n  -i INTERVALL, --intervall INTERVALL\n                        minimum interval between updates (default: 3600)\n  -H HOST, --host HOST  hostname or ip address (default: localhost)\n  -P PORT, --port PORT  connection port (default: 3306)\n  -u USER, --user USER  connection username (default: mediathekview)\n  -p PASSWORD, --password PASSWORD\n                        connection password (default: None)\n  -d DATABASE, --database DATABASE\n                        database name (default: mediathekview)\n````\n\n\n\nDocker Container (with internal MYSQL database)\n-----------------------------------------------\nThe standalone database inkl. regular update (cronjob) via `mvupdate3` can be run inside a docker container. The image is based on the mariadb container from linuxserver.io (see https://docs.linuxserver.io/images/docker-mariadb).\n\n\n**Build Container:**\n\nDownload the repository via zip (+ unpack) or git clone to the computer with installed docker. Then go to `plugin.video.mediathekview` and build the Image :\n\n````\ndocker build -t mediathekview-kodi-db .\n````\n\n\n**Container Configuration:**\n\n| Env                 | Default Value       | Function        |\n| -----------------   | --------------      | --------------- |\n| PUID                | 1000                | for UserID; also see explanation on linuxserver.io| \n| GUID                | 1000                | for GroupID; also see explanation on linuxserver.io| \n| TZ                  | Europe/London       | used timezone in the Container |\n| MYSQL_DATABASE      | mediathekview       | name of the MYSQL database; this database will be created during first startup of the Container|\n| MYSQL_USER          | mediathekview       | superuser of the MYSQL database|\n| MYSQL_PASSWORD      | mediathekview       | password for MYSQL_USER (minimum 4 characters); should be changed to a secure password |\n| MYSQL_ROOT_PASSWORD | mediathekview_root  | root password for the MYSQL database (minimum 4 characters); should be changed to a secure password|\n| CRON_TIMESPEC       | 0 4-22/1 * * *      | time specification for cronjob; specifies when database is updated using `mvupdate3` (default: hourly between 4am and 10pm). A generator for cron time specification can be found for example here: https://crontab.guru/| \n| RUN_ON_STARTUP      | no                  | if 'yes', `mvupdate3` will be executed on container startup\n\n\n\nIn order to access the database from outside the container (e.g. by Kodi addon) the `port 3306` has to be exposed. However, if using several MYSQL Containers this port should be forwarded to a free port (e.g. `-p 49153:3306`). *Remark:* Inside the container the usual port 3306 is used (e.g. when executing `mvupdate3`). Outside the container resp. in Kodi the configured port (49153 in the example) hast to be used.\n\nThe database itselve as well as other configuration data is stored in the folder `/config`. This folder is configured as docker volume (`-v path_to_data:/config`) and its content is persistent even if re-initialize the container.\n\n\n**Start the container (exemplaric):**\n````\ndocker run -d \\\n  --name mediathekview-kodi-db \\\n  -e PUID=1000 \\\n  -e GUID=1000 \\\n  -e TZ='Europe/Berlin' \\\n  -e MYSQL_DATABASE='mediathekview' \\\n  -e MYSQL_USER='mediathekview' \\\n  -e MYSQL_PASSWORD='mediathekview' \\\n  -e MYSQL_ROOT_PASSWORD='mediathekview_root' \\\n  -e CRON_TIMESPEC='0 4-22/1 * * *' \\\n  -p 3306:3306 \\\n  -v path_to_data:/config \\\n   mediathekview-kodi-db\n````\n\n\n**Remarks:**\n* The log output of `mvupdate3` might be shown with a delay in the docker log.\n* In order to safe memory maria-db binlog can be disabled by editing `/config/custom.cnf`: Replace `log_bin = /config/log/mysql/mariadb-bin` with `skip-log-bin`. Further information about binlog can be found [here](https://mariadb.com/kb/en/binary-log/).\n\n\n\nVersione Italiana\n=================\n\nUn altro addon Kodi per la navigazione nelle piattaforme video operate dalle\nemittenti pubbliche tedesche... Perchè?\n\nPerché l'approccio di questo addon è diverso da quello degli altri addon\ndisponibili: questo addon utilizza il database del grande progetto\n_\"MediathekView\"_, che viene aggiornato ogni ora e contiene oltre 200.000 voci\nda tutte le piattaforme video tedesche. Questo approccio presenta alcuni\nvantaggi significativi rispetto agli altri addon, che cercano di scansionare\ni siti delle piattaforme video in tempo reale:\n\n* Navigazione nella libreria ad alta velocità\n* Indipendenza da qualsiasi modifica al layout di pagina delle librerie multimediali\n* Alta affidabilità\n\nSe avete domande o suggerimenti riguardo quest'addon, non esitate ad utilizzare\nil [forum in lingua inglese][2] o [in lingua tedesca][1] tedesco. Errori e\nsuggerimenti per nuove funzionalità possono anche essere segnalati direttamente\ncome [GitHub Issue][3]. Il sorgente è disponibile in un [Repository GitHub][4].\n\n\nHighlights\n----------\n* Attualizzazione della banca dati in background\n* Navigazione e ricerca velocissima\n* Scaricamento video con generazione automatica die file NFO e scaricamento\n  sottotitoli\n* Banca dati interna o banca dati condivisa a base MySQL\n* Interfaccia disponibile in Italiano, Inglese e Tedesco\n\n\nCome funziona\n-------------\n\nL'addon scarica il database da MediathekView e lo importa in un database SQLite\nlocale o, in alternativa, in un database MySQL locale o remoto (per l'uso da\nparte di molteplici sistemi Kodi). Durante il runtime di Kodi, i file di\naggiornamento differenziali vengono scaricati da MediathekView in un intervallo\nconfigurabile (predefinito: 2 ore) ed importati nel database. Al più tardi\nentro il giorno successivo all'ultimo aggiornamento, l'aggiornamento sarà\nnuovamente effettuato tramite l'aggiornamento completo di Mediathekview.\n\nIdealmente, l'utilizzo del database locale richiede un file system con\nprestazioni accettabili. Un Raspberry di prima generazione con una scheda SD\nlenta non è certamente la miglior scelta ma sempre ancora accettabile. La\ndurata di un aggiornamento completo in questo caso sarà intorno ai 15-20\nminuti. Ma poiché questo accade in background, l'impatto sarà accetabile.\n\nL'addon è stato testato su diverse piattaforme in Linux, MacOS, Windows e\nLibreELEC nonchè OpenELEC. Anche diversi sistemi Android sono stati testati\ncon successo. A causa della varietà delle piattaforme, tuttavia, non è\npossibile fare una dichiarazione finale di compatibilità.\n\nInstall\n-------------------\n\nIl plugin Mediathekview può essere utilizzato per Kodi (17-20) da singoli repository.\n\nSi prega di controllare il [GITHUB Repository] [5] per maggiori dettagli.\n\nQuando si compila da GITHUB, è necessario adattare addon.xml di conseguenza (Kodi 17 e\nKodi 18\u003e addon.kodi18.xml / Kodi 19 \u0026 Kodi 20 \u003e addon.kodi19.xml). Questo non è consigliato, \npoiché dovrai installare l'aggiornamento e le correzioni da solo.\n\n\nCome funzionano i metodi di aggiornamento\n-----------------------------------------\n\nL'addon supporta 5 diversi metodi di aggiornamento:\n* **Di continuo:** Questo metodo aggiorna il database una volta per ogni\nintervallo di aggiornamento impostato (impostazione predefinita: 2 ore).\nIl primo aggiornamento di un giorno è un aggiornamento completo, tutti gli\naltri sono aggiornamenti differenziali.\n* **Automatico (Predefinito):** Questo metodo aggiorna automaticamente il\ndatabase. L'aggiornamento avviene una volta per ogni intervallo di\naggiornamento impostato (impostazione predefinita: 2 ore). Il primo\naggiornamento di un giorno è un aggiornamento completo, tutti gli altri sono\naggiornamenti differenziali. L'aggiornamento automatico si interrompe se\nl'addon non è stato utilizzato per più di 2 ore al fine di salvare larghezza\ndi banda e corrente sui dispositivi mobili.\n* **Solo all'avvio:** L'aggiornamento avviene non appena l'addon viene\ninvocato. Se questo è il primo aggiornamento del giorno, avverrà un\naggiornamento completo, altrimenti differenziale. Tutti gli ulteriori\naggiornamenti dovranno essere avviati manualmente dall'utente attraverso il\nmenu principale.\n* **Manuale:** Non vi è alcun aggiornamento automatico. L'utente ha la\npossibilità di avviare gli aggiornamenti tramite il menu principale. Se questo\nè il primo aggiornamento del giorno, avverrà un aggiornamento completo,\naltrimenti differenziale.\n* **Disattivato:** Non vi è alcun aggiornamento automatico. Questa\nconfigurazione ha senso solo se il plugin utilizza un database esterno che\nviene aggiornato altrove.\n\n\nConfigurazioni alternative\n--------------------------\n\nSe il sistema Kodi è troppo lento per gestire il database interno (ad es.\nRaspberry PI con una scheda SD molto lenta) o se si desidera condividere il\ndatabase con altri sistemi Kodi, è anche possibile utilizzare l'addon con un\nserver database esterno (MySQL o MariaDB).\n\nDal momento che molti utenti Kodi hanno il proprio sistema NAS per rendere i\nloro contenuti mediali disponibili al media center, questo è di solito anche\nadatto come server di database MySQL/MariaDB, dal momento che quasi tutti i\nsistemi operativi NAS offrono l'installazione di un tale database.\n\nSe l' addon è configurato per utilizzare un database MySQL/MariaDB, il database\nverrà creato automaticamente se non esiste ancora sul database server.\nTuttavia, anche l'utente del database specificato deve avere i diritti\nnecessari alla creazione di un database.\n\nIl collegamento al database può essere effettuato nelle impostazioni \ndell'addon nella sezione \"Impostazioni Banca Dati\".\n\nSe almeno uno dei sistemi Kodi collegati è in grado di aggiornare il database,\nl'addon funzionerà su tutti i sistemi Kodi. In caso contrario, è anche\npossibile eseguire il processo di aggiornamento su un altro sistema (ad es. il\nNAS, il server di database o un altro sistema).\n\n\nProcesso esterno di aggiornamento del database\n----------------------------------------------\n\nPer eseguire il processo esterno di aggiornamento del database, è necessario\nche sul sistema sul quale il processo viene eseguito sia istallato un\ninterprete python, il programma di decompressione 'xz' e le seguenti\nlibrerie python:\n\n* mysql-connector\n\nQUeste potranno essere istallate mediante il programma pip:\n\n````\nPython 2:\nsudo apt install python-pip\npip install mysql-connector-python\nPython 3:\nsudo apt install python3-pip\npip3 install mysql-connector-python\n````\n\nIl programma di aggiornamento si chiama `mvupdate` (`mvupdate3` per Python 3) e si trova nella directory\nprincipale dell'addon e dovrà essere lanciato da questa directory. L'intero\naddon dovrà essere copiato sul sistema di destinazione.\n\nQuesto sarà possibile sia scaricando l'archivio dell'addon che dovrà essere\nspacchettato in loco o mediante clonaggio dai sorgenti mediante `git`\n\n````\ngit clone https://github.com/mediathekview/plugin.video.mediathekview.git\n````\n\nSpecificando l'opzione `-h` a se stante o a tergo del tipo di database da\naggiornare, l'applicazione mostrerà le opzioni disponibili:\n\n````\nleo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h\nusage: mvupdate mysql [-h] [-H HOST] [-P PORT] [-u USER] [-p PASSWORD]\n                      [-d DATABASE]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -v, --verbose         show progress messages (default: 0)\n  -f, --force           ignore the minimum interval (default: False)\n  -F, --full            ignore the minimum interval and force a full update\n                        (default: False)\n  -i INTERVALL, --intervall INTERVALL\n                        minimum interval between updates (default: 3600)\n  -H HOST, --host HOST  hostname or ip address (default: localhost)\n  -P PORT, --port PORT  connection port (default: 3306)\n  -u USER, --user USER  connection username (default: mediathekview)\n  -p PASSWORD, --password PASSWORD\n                        connection password (default: None)\n  -d DATABASE, --database DATABASE\n                        database name (default: mediathekview)\n````\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmediathekview%2Fplugin.video.mediathekview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmediathekview%2Fplugin.video.mediathekview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmediathekview%2Fplugin.video.mediathekview/lists"}