update readme, GetLatLangFromCity.php

3 files changed, 111 insertions, 1 deletions

diff --git a/README b/README
index b7944612..90547b83 100644
--- a/README
+++ b/README
@@ -58,6 +58,114 @@ Versteckte Einstellungen sind Einstellungen die in der VDR setup.conf konfigurie
 * MenuItemParseTilde - Wenn die Einstellung auf 1 gesetzt ist, wird beim Menü-Item-Text auf den Buchstaben Tilde '~' geprüft und wenn eine Tilde gefunden wurde, wird die Tilde entfernt und alles was nach der Tilde steht in einer anderen Farbe dargestellt. Dies ist z.B. interessant wenn man epgsearch hat.
 * ChannelBitrateShowCalcInterval - In welchen Intervall soll die Bitrate (Kanalanzeige) aktualisiert werden (default 20)
 
+Widgets
+_______________________________
+h1. Widgets
+
+Seit Version 0.5.0 gibt es die Widgets.
+Es gibt interne und externe Widgets. Die internen Widgets funktionieren out-of-the-box, da Sie innerhalb des VDR implementiert sind.
+Externe Widgets sind externe Programme/Scripte, hier sind (teilweise) manuelle Anpassungen notwendig damit diese laufen.
+
+Die Widgets werden auf der rechten Seite des Hauptmenüs angezeigt. In der Höhe ist nur begrenzt Platz, deshalb kann es passieren das nicht alle Widgets angezeigt werden können (da einfach kein Platz mehr ist). Hier muss du selbst entscheiden welches Widget auf welcher Position angezeigt werden soll.
+
+h2. Interne Widgets
+
+h3. DVB Geräte
+
+Zeigt die DVB Geräte an, wer dieses benutzt und auf welchem Kanel das Gerät gerade ist. Über die Plugineinstellungen kann konfiguriert werden ob "unbekannte" und/oder "nicht benutzte" Geräte ausgeblendet werden sollen.
+Leider ist es derzeit nicht möglich 100% herauszufinden wer das Gerät derzeit nutzt. Z.B. gibt es Fälle wie den EPG-Scan welcher nicht erkannt wird.
+
+h3. Aktive Timer
+
+Zeit die aktiven Timer an. Über die Plugineinstellungen kann die max. Anzahl der Timer konfiguriert werden welche angezeigt wird. Weiter kann konfiguriert werden, dass das Widget ausgeblendet wird, wenn keine aktiven Timer existieren.
+
+h3. Timer Konflikte
+
+Zeigt die Anzahl der Timer-Konflikte an. Es ist in Plannung das auch die eigentlichen Konflikte und nicht nur die Anzahl angezeigt wird. Es kann wieder konfiguriert werden das das Widget ausgeblendet wird wenn keine Timer Konflikte vorhanden sind.
+
+h3. Letzte Aufnahmen
+
+Zeigt die letzten Aufnahmen nach Datum sortiert an. Über die Plugineinstellungen kann die max. Anzahl der Elemente konfiguriert werden.
+
+h2. Externe Widgets
+
+Externe Scripte werden (wenn nicht anders konfiguriert) in das LIBDIR installiert. Normalerweise sollte dies folgender Pfad sein.
+<pre>
+/usr/local/lib/vdr/skinflatplus/widgets/
+</pre>
+
+Alle Ausgaben der Scripte sind unter
+<pre>
+/tmp/skinflatplus/widgets/
+</pre>
+
+h3. Wetter-Widget
+
+Zeigt das aktuelle Wetter und eine Vorschau an. Die Ansicht der Vorschau kann konfiguriert werden. Es existiert eine Lang- und eine Kurzansicht. Bei der langen Ansicht gibt es pro Tag eine Zeile bei der kurzen Ansicht wird alles in einer Zeile dargestellt. Die Anzahl der Tage kann über die Plugineinstellungen konfiguriert werden, wobei max. 7 Tage möglich sind.
+Dieses Widget benötigt php5, unter Ubuntu ist z.B. das Paket php5-cli notwendig.
+Im Ordner existiert eine update_weather.config.sample diese muss nach update_weather.config kopiert werden.
+<pre>
+cd /usr/local/lib/vdr/skinflatplus/widgets/weather
+cp update_weather.config.sample update_weather.config
+</pre>
+Anschließend muss Latitude und Longitude vom Ort ermittelt werden, dafür gibt es das kleine php-Script GetLatLangFromCity.php. Einfach ausführen und den Ort eingeben.
+<pre>
+php5 GetLatLangFromCity.php
+</pre>
+Die Werte von Latitude und Longitude in die update_weather.config schreiben und auch den Wert "LocationSkin" entsprechend anpassen. "LocationSkin" wird später im Skin als Ort angezeigt.
+
+Das Script (update_weather.php) wird nicht vom Skin aufgerufen. Dies muss extern über cron oder ähnliches erfolgen. Z.B. über folgende Zeile in der /etc/crontab
+<pre>
+# update weather every 12 hours
+7 */12   * * *   root    php5 /usr/local/lib/vdr/skinflatplus/widgets/weather/update_weather.php
+</pre>
+
+Für die Wetterdaten wird forecast.io verwendet. Hier sind 1000 Abfragen am Tag frei, jede weiteren 10.000 Abfragen kosten dann $1. Pro Aufruf von update_weather.php werden 2 Abfragen getätigt. Bitte registriere dich kostenlos bei forecast.io und erstelle einen eigenen Api-Key. Diesen dann einfach in die update_weather.config eintragen. Hierfür ist nur eine E-Mail Adresse + Passwort notwendig. Wenn das Script nicht mehr funktioniert sind höchstwahrscheinlich die 1000 Abfragen/Tag überschritten.
+
+Für die Kanalinfo gibt es eine kleine Version des Wetter Widgets. hier wird Heute + Morgen angezeigt.
+
+h3. System-Informationen
+
+Mit diesem Widget können verschiedenene Systeminformationen angezeigt werden.
+Dieses Script wird bei jedem Aufruf des Menü erneut ausgeführt. Daher sollte das Script kurz und schnell sein.
+Es wird das Script "system_information" ausgeführt. Dieses muss manuell verlinkt werden! Für Ubuntu z.B. wie folgt
+<pre>
+cd /usr/local/lib/vdr/skinflatplus/widgets/system_information
+ln -s system_information.ubuntu system_information
+</pre>
+
+In dem Script ist auch die Konfiguration enthalten. Hier kann festgelegt werden welche Informationen ausgegeben werden sollen und in welcher Position diese sein sollen.
+
+h3. Temperaturen
+
+Mit diesem Widget können die Temperaturen des System angezeigt werden.
+Dieses Script wird bei jedem Aufruf des Menü erneut ausgeführt. Daher sollte das Script kurz und schnell sein.
+Es wird das Script "temperatures" ausgeführt. Dieses muss manuell verlinkt werden! Z.B. wie folgt
+<pre>
+cd /usr/local/lib/vdr/skinflatplus/widgets/temperatures
+ln -s temperatures.default temperatures
+</pre>
+
+Das default Script nutzt lm-sensors um die Temeperaturen zu ermitteln. Du musst sicherstellen das du lm-sensors installiert und auch richtig konfiguriert hast. Weiterhin wird die GPU-Temperatur mittels nvidia-settings ermittelt. Dies funktioniert natürlich nur mit Nvidia Grafikkarten.
+
+h3. System-Updatestatus
+
+Mit diesem Widget können die Updates des System angezeigt werden. Dabei wird die Anzahl der Updates und der Sicherheitsupdates angezeigt.
+Das Script (system_update_status) wird nicht vom Skin aufgerufen. Dies muss extern über cron oder ähnliches erfolgen. Z.B. über folgende Zeile in der /etc/crontab
+<pre>
+# update system_updates every 12 hours
+7 */12   * * *   root    /usr/local/lib/vdr/skinflatplus/widgets/system_updatestatus/system_updatestatus
+</pre>
+
+h3. Benutzerdefinierte Ausgabe
+
+Mit diesem Widget können eigene Befehle ausgeführt und angezeigt werden.
+Wenn es in dem Ordner das Script "command" gibt, wird dieses bei jedem Aufruf des Menüs ausgeführt.
+Das Script command muss 2 Dateien bereitstellen: title & output
+Jeweils für den Titel und der eigentlichen Ausgabe.
+Es sollte darauf geachtet werden das nicht zu viele Zeilen ausgeben werden da immer die gesamte Datei angezeigt wird. Die Zeilen werden rechts einfach abgeschnitten und nicht umgebrochen!
+
+
 TVScraper & scraper2vdr
 -------------------------------
 Since version 0.3.0 the skin support TVScraper & scraper2vdr.
diff --git a/widgets/weather/GetLatLangFromCity.php b/widgets/weather/GetLatLangFromCity.php
index 1ca7d1e3..7a76f90c 100644
--- a/widgets/weather/GetLatLangFromCity.php
+++ b/widgets/weather/GetLatLangFromCity.php
@@ -20,6 +20,8 @@ $longitude = $data['results'][0]['geometry']['location']['lng'];
 
 echo "Latitude =  ".$latitude."\n";
 echo "Longitude = ".$longitude."\n";
+echo "LocationSkin = ".$city."\n";
+
 echo "put these values in update_weather.config\n";
 
 ?>
diff --git a/widgets/weather/README b/widgets/weather/README
index af7f985e..f44aff18 100644
--- a/widgets/weather/README
+++ b/widgets/weather/README
@@ -8,6 +8,6 @@ You need php5 with command line support for this widget. For example in Ubuntu y
 
 Please move update_weather.config to update_weather.config.sample
 
-mv update_weather.config.sample update_weather.config
+cp update_weather.config.sample update_weather.config
 
 Configure your location and others in update_weather.config. Use php-script "GetLatLangFromCity.php" to get latitude & longitude from your location.