Skip to content

Commit

Permalink
Merge pull request #37 from mediathekview/develop
Browse files Browse the repository at this point in the history 
Release 0.4.0
  • Loading branch information
@tuxpoldo
tuxpoldo committed Jan 14, 2018
2 parents 784e8c6 + cd46dd2 commit 8e49dce
Show file tree
Hide file tree
Showing 36 changed files with 1,021 additions and 1,121 deletions.
164 changes: 76 additions & 88 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -64,25 +64,16 @@ dies bedeutet, dass eine lokale SQLite-Datenbank benutzt wird, die auch
durch das Kodi-System lokal aktualisiert wird. Dies dürfte auch das
üblichste Szenario sein.

Dieses Szenario birgt zwei Voraussetzungen die erfüllt sein sollten:
* ein einigermaßen performantes Dateisystem für die Datenbank. Ein Raspberry
mit seiner langsamen SD-Karte ist in diesem Fall sicherlich nicht die
allerbeste Wahl. Das vollständige Update der Datenbank dauert hier um die
15-20 Minuten. Da dies aber im Hintergrund passiert, kann man unter Umständen
gut damit leben.
* der Entpacker 'xz' auf dem Kodi-System. Um den Datenbank-Aktualisierer zu
benutzen, muss dieses Programm auf dem System in einem der Standard-
Verzeichnisse (/bin, /usr/bin, /usr/local/bin) installiert werden.
Unter Windows bzw. falls das Programm in einem anderen Verzeichnis
installiert ist, muss der Pfad zum Programm in den Addon-Einstellungen
angegeben werden. Sollte der Entpacker nicht vorhanden sein, so gibt
das Addon eine Meldung aus und deaktiviert den Aktualisierungsprozess.

Das Addon wurde auf verschiedenen Plattformen unter Linux, MacOS und LibreELEC
bzw. OpenELEC getestet. Dort war auch der entsprechende Entpacker verfügbar.
Unter Windows muss der Entpacker nachträglich installiert werden und dessen
Pfad in den Addon-Einstellungen angegeben werden. Mangels Testsystem konnte
dies jedoch zum jetzigen Zeitpunkt noch nicht getestet werden.
Die Benutzung der lokalen Datenbank erfordert im Idealfall ein einigermaßen
performantes Dateisystem. Ein Raspberry mit seiner langsamen SD-Karte ist in
diesem Fall sicherlich nicht die allerbeste Wahl. Das vollständige Update der
Datenbank dauert auf einem solchen System erfahrungsgemäß um die 15-20 Minuten.
Da dies aber im Hintergrund passiert, kann man unter Umständen gut damit leben.

Das Addon wurde auf verschiedenen Plattformen unter Linux, MacOS, Windows und
LibreELEC bzw. OpenELEC getestet. Auch verschiedene Android Systeme konnten
schon erfolgreich getestet werden. Wegen der Vielzahl der Plattformen ist es
allerdings nicht möglich eine abschließende Kompatibilitätsaussage zu machen.


Alternativ-Konfigurationen
Expand All @@ -95,11 +86,13 @@ Datenbank (MySQL) zu nutzen.

Da viele Kodi-Nutzer über ein eigenes NAS-System verfügen um ihre Medien
dem Media-Center zur Verfügung zu stellen, eignet sich dieses in der Regel
auch als MySQL Datenbank-Server da nahezu alle NAS-Betriebssysteme die
Installation eines solchen anbieten.
auch als MySQL bzw. MariaDB Datenbank-Server da nahezu alle NAS-Betriebssysteme
die Installation eines solchen anbieten.

Hierfür muss lediglich die entsprechende Datenbank im MySQL Server mit
dem SQL-Skript `resources/sql/filmliste-mysql-v1.sql` erzeugt werden.
Ist das Addon so konfiguriert, dass eine MySQL/MariaDB Datenbank genutzt werden
soll, erzeugt dieses die Datenbank selbsttätig, falls diese auf dem
Datenbankserver noch nicht existiert. Der angegebene Datenabankbenutzer muss
dafür allerdings auch die Rechte besitzen.

Die Verbindung zur Datenbank kann in den Addon-Einstellungen im Abschnitt
_"Datenbank Einstellungen"_ vorgenommen werden.
Expand All @@ -117,7 +110,7 @@ Standalone Datenbank Update Prozess
Um die Datenbankaktualisierung von der Kommandozeile auszuführen, muss das
Zielsystem einen python2-Interpreter bereitstellen. Des weiteren müssen noch
folgende zwei Bibliotheken zur Verfügung stehen, sowie das Entpackprogramm
'xz':
'xz' (optional):

* ijson
* mysql-connector
Expand Down Expand Up @@ -145,19 +138,18 @@ das Programm spezifische Hilfe aus. Beispiel:

````
leo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h
usage: mvupdate mysql [-h] [-H HOST] [-u USER] [-p PASSWORD] [-d DATABASE]
usage: mvupdate mysql [-h] [-H HOST] [-P PORT] [-u USER] [-p PASSWORD]
[-d DATABASE]
optional arguments:
-h, --help show this help message and exit
-H HOST, --host HOST hostname or ip of the MySQL server (default:
localhost)
-u USER, --user USER username for the MySQL server connection (default:
filmliste)
-H HOST, --host HOST hostname or ip address (default: localhost)
-P PORT, --port PORT connection port (default: 3306)
-u USER, --user USER connection username (default: mediathekview)
-p PASSWORD, --password PASSWORD
password for the MySQL server connection (default:
None)
connection password (default: None)
-d DATABASE, --database DATABASE
MySQL database for mediathekview (default: filmliste)
database name (default: mediathekview)
````


Expand Down Expand Up @@ -216,22 +208,16 @@ After installation, the addon starts in local mode: this means that a local
SQLite database is used, which is also updated locally by the Kodi system.
This is probably the most common scenario.

* a file system with a decent performance for the database. A Raspberry with
its slow SD card is certainly not the very best choice in this case but still
acceptable. The full update will take in this case about 15-20 Minutes but
since this happens in the background, you may be able to live with it.
* The unpacker 'xz' on the Kodi system. To use the database updater, this
program must be installed on the system in one of the standard directories
(/bin, /usr/bin, /usr/local/bin). Under Windows or if the program is
installed in a different directory, the path to the program must be specified
in the addon settings. If the unpacker is not available on the target system,
the addon issues a message and disables the update process.
Ideally, using the local database requires a file system with a decent
performance. A Raspberry with a slow SD card is certainly not the very
best choice in this case but still acceptable. The full update will take
in this case about 15-20 Minutes but since this happens in the background,
you may be able to live with it.

The addon has been tested on different platforms under Linux, MacOS and
LibreELEC/OpenELEC. The corresponding unpacker was also available there.
Under Windows, the unpacker must be manually installed and its path must
be specified in the addon settings. Due to the lack of a test system,
however, this could not be tested at the present time.
The addon has been tested on different platforms under Linux, MacOS,
Windows and LibreELEC/OpenELEC. Various Android systems have also been
tested successfully. Due to the variety of platforms, however, it is not
possible to make a final compatibility statement.


Alternate Configurations
Expand All @@ -242,8 +228,13 @@ with a very slow SD card) or if the program 'xz' is missing, it is also
possible to use the addon with an external database (MySQL).

Since many Kodi users have their own NAS system to make their media available
to the media center, this is usually also suitable as a MySQL database server
since almost all NAS operating systems offer the installation of MySQL.
to the media center, this is usually also suitable as a MySQL/MariaDB database
server since almost all NAS operating systems offer the installation of MySQL.

If the addon is configured to use a MySQL/MariaDB database, the database is
created automatically if it does not yet exist on the database server. However,
the specified database user must also have sufficient user rights in order to
do this.

When you have a running MySQL server avaible, you have only to create the
database by running the SQL script `resources/sql/filmliste-mysql-v1.sql`.
Expand Down Expand Up @@ -289,19 +280,18 @@ the application shows specific help instructions:

````
leo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h
usage: mvupdate mysql [-h] [-H HOST] [-u USER] [-p PASSWORD] [-d DATABASE]
usage: mvupdate mysql [-h] [-H HOST] [-P PORT] [-u USER] [-p PASSWORD]
[-d DATABASE]
optional arguments:
-h, --help show this help message and exit
-H HOST, --host HOST hostname or ip of the MySQL server (default:
localhost)
-u USER, --user USER username for the MySQL server connection (default:
filmliste)
-H HOST, --host HOST hostname or ip address (default: localhost)
-P PORT, --port PORT connection port (default: 3306)
-u USER, --user USER connection username (default: mediathekview)
-p PASSWORD, --password PASSWORD
password for the MySQL server connection (default:
None)
connection password (default: None)
-d DATABASE, --database DATABASE
MySQL database for mediathekview (default: filmliste)
database name (default: mediathekview)
````


Expand Down Expand Up @@ -344,25 +334,22 @@ Come funziona

L'addon scarica il database da MediathekView e lo importa in un database SQLite
locale o, in alternativa, in un database MySQL locale o remoto (per l'uso da
parte di più client Kodi).
Durante il runtime di Kodi, i file differenziali vengono scaricati da
MediathekView in un intervallo configurabile (predefinito: 2 ore) ed importati
nel database. Al più tardi entro il giorno successivo all'ultimo aggiornamento,
l'aggiornamento sarà nuovamente effettuato tramite l'aggiornamento completo
di Mediathekview.

* Un file system con prestazioni accettabili per il database. Un Raspberry con
la sua lenta scheda SD non è certamente la miglior scelta ma sempre ancora
accettabile. La durata di un aggiornamento completo in questo caso sarà
intorno ai 15-20 minuti. Ma poiché questo accade in background, l'impatto
sarà essere accetabile.
* Il decompressore 'xz' sul sistema Kodi. Per utilizzare il programma di
aggiornamento del database, questo programma deve essere installato sul
sistema in una delle directory standard (/bin, /usr/bin, /usr/local/bin). In
Windows o se il programma è installato in una directory diversa, il percorso
del programma deve essere specificato nelle impostazioni dell'addon. Se il
decompressore non è disponibile per il sistema, l'addon mostra un messaggio
e disabilita il processo di aggiornamento.
parte di molteplici sistemi Kodi). Durante il runtime di Kodi, i file di
aggiornamento differenziali vengono scaricati da MediathekView in un intervallo
configurabile (predefinito: 2 ore) ed importati nel database. Al più tardi
entro il giorno successivo all'ultimo aggiornamento, l'aggiornamento sarà
nuovamente effettuato tramite l'aggiornamento completo di Mediathekview.

Idealmente, l'utilizzo del database locale richiede un file system con
prestazioni accettabili. Un Raspberry di prima generazione con una scheda SD
lenta non è certamente la miglior scelta ma sempre ancora accettabile. La
durata di un aggiornamento completo in questo caso sarà intorno ai 15-20
minuti. Ma poiché questo accade in background, l'impatto sarà accetabile.

L'addon è stato testato su diverse piattaforme in Linux, MacOS, Windows e
LibreELEC nonchè OpenELEC. Anche diversi sistemi Android sono stati testati
con successo. A causa della varietà delle piattaforme, tuttavia, non è
possibile fare una dichiarazione finale di compatibilità.


Configurazioni alternative
Expand All @@ -374,11 +361,13 @@ Raspberry PI con una scheda SD molto lenta) o se manca il programma 'xz',

Dal momento che molti utenti Kodi hanno il proprio sistema NAS per rendere i
loro contenuti mediali disponibili al media center, questo è di solito anche
adatto come server di database MySQL, dal momento che quasi tutti i sistemi
operativi NAS offrono l'installazione di un tale database.
adatto come server di database MySQL/MariaDB, dal momento che quasi tutti i
sistemi operativi NAS offrono l'installazione di un tale database.

Dopodiche sarà sufficiente creare la banca dati mediante lo script SQL
disponibile in `resources/sql/filmliste-mysql-v1.sql`.
Se l' addon è configurato per utilizzare un database MySQL/MariaDB, il database
verrà creato automaticamente se non esiste ancora sul database server.
Tuttavia, anche l'utente del database specificato deve avere i diritti
necessari.

Il collegamento al database può essere effettuato nelle impostazioni
dell'addon nella sezione "Impostazioni Banca Dati".
Expand Down Expand Up @@ -423,17 +412,16 @@ aggiornare, l'applicazione mostrerà le opzioni disponibili:

````
leo@bookpoldo ~/plugin.video.mediathekview $ ./mvupdate mysql -h
usage: mvupdate mysql [-h] [-H HOST] [-u USER] [-p PASSWORD] [-d DATABASE]
usage: mvupdate mysql [-h] [-H HOST] [-P PORT] [-u USER] [-p PASSWORD]
[-d DATABASE]
optional arguments:
-h, --help show this help message and exit
-H HOST, --host HOST hostname or ip of the MySQL server (default:
localhost)
-u USER, --user USER username for the MySQL server connection (default:
filmliste)
-H HOST, --host HOST hostname or ip address (default: localhost)
-P PORT, --port PORT connection port (default: 3306)
-u USER, --user USER connection username (default: mediathekview)
-p PASSWORD, --password PASSWORD
password for the MySQL server connection (default:
None)
connection password (default: None)
-d DATABASE, --database DATABASE
MySQL database for mediathekview (default: filmliste)
database name (default: mediathekview)
````
Loading

0 comments on commit 8e49dce

Please sign in to comment.