====== Icon-Watchdog ====== Version History... [[https://github.com/Woersty/LoxBerry-Plugin-Icon-Watchdog/commits/main|Plugin-Historie]] \\ ---- == Nur bis einschließlich Loxone Config Version 12 == Laut [[https://www.loxforum.com/forum/projektforen/loxberry/plugins/307337-loxberry-plugin-icon-watchdog?p=364496#post364496|Berichten im Loxforum]] hat Loxone das Icon-Handling ab Version 13 geändert. Damit funktioniert dieses Plugin nur noch bis einschließlich Version 12. ===== Download ===== [[https://github.com/Woersty/LoxBerry-Plugin-Icon-Watchdog/archive/refs/tags/2022.06.11.zip]] ===== Funktion des Plugins ===== Das Plugin dient dazu, die images.zip Datei auf dem Loxone Miniserver zu überwachen. Diese Datei enthält die Symbole, welche in der Visualisierung zu sehen sind. Bei jedem Miniserver-Firmware-Update wird diese Datei überschrieben und eigene Icons / Symbole fehlen wieder. Damit ich diese nicht immer wieder händisch auf den Miniserver kopieren muss, habe ich das Plugin gebaut. Weiterhin bietet das Plugin die Möglichkeit, eigene Symbole relativ einfach in die Loxone App einzubinden. ===== Installation ===== Das Plugin wird normal über die Plugin-Verwaltung installiert. Im Tutorial Video wird dies kurz gezeigt (siehe unten) ===== Updates ===== Das Plugin unterstützt automatische Updates. Dabei werden die vorhandenen Daten beibehalten. ===== Konfigurationsoptionen ===== Keine ===== Einrichtung in der Loxone Config Software ===== In der Loxone Config muss man zuerst die gewünschten neue Symbole anlegen. Es gibt drei Typen. Raumsymbole, Kategoriesymbole und Statussymbole. ===== Einrichtung / Verwendung des Plugins ===== Die Informationen zu den in der Loxone Config angelegten Symbolen sind in der .Loxone Projektdatei enthalten. Diese Datei wird ins Plugin importiert. Anschließend zeigt das Plugin alle konfigurierten Symbole und die dazugehörigen Symbole an. Wird kein Symbol gefunden, wird der Eintrag **rot** dargestellt. Änderbare, eigene Symbole, für die ein Symbol-Bild vorhanden ist, werden **grün** angezeigt. Die Standard-Symbole, welche von Loxone ausgeliefert wurden, werden **grau** dargestellt sind aber nicht editierbar. ===== Anleitungsvideo ===== Es gibt auf YouTube ein Video, welches die Grundinstallation und erste Verwendung erklärt. Das Video hat deutsche und englische Untertitel. Diese bitte entsprechend der Sprache auswählen. {{youtube>M-uOfNNmlmw}} ===== Bedienung ===== Nach der Ersteinrichtung empfehle ich folgende Schritte für das Hinzufügen neuer Symbole: * Laden der aktuellen Konfiguration aus dem Miniserver * Anlegen der gewünschten Symbole in der Loxone Config - dabei nichts in den Symboleditor malen - nur OK drücken * Speichern des Projektes mit der Diskette oben links in der Loxone Config  * Import des Projektes in das Plugin durch Drag&Drop in die grüne Box (oder klicken in selbige) * Durch einen Klick auf {{plugins:icon_watchdog:1269958882.png?100}} werden die konfigurierten Symbole im Plugin dargestellt. * Jetzt können neue SVG-Dateien per Drag&Drop in die blaue Box importiert werden (oder klicken in selbige) * Dann auf ein Symbol, welches geändert werden soll klicken und aus dem Symbol-Browser das Symbol aussuchen * Wenn man alle neuen Symbole zugeordnet hat nochmal auf {{plugins:icon_watchdog:1269958882.png?100}}klicken. (Achtung! Der Miniserver bootet neu.) ===== Eigene Symbolbilder - Was ist eine SVG - Datei und wie mache ich die? ===== SVG bedeutet **s**kalierbare **V**ektror**g**rafik. Die Symbole, welche das Plugin verarbeiten kann müssen ein paar Voraussetzungen erfüllen. Bei Nichterfüllung wird das Plugin die Grafik ablehnen. Diese sind derzeit: * **Maximale Größe 25kB** - man sollte aber versuchen unter 3 kB zu bleiben. Tipp: [[https://vecta.io/nano]] zum Verkleinern der Dateigröße. * Die **viewBox Einstellung muss** ''%%0 0 32 32%%'' **sein** Ich empfehle daher, sich durch einen Klick auf {{plugins:icon_watchdog:1269958884.png?150}} eine Beispieldatei herunterzuladen und diese anzupassen. Als Editor bietet sich zum Beispiel [[https://inkscape.org/de/release/1.1/windows/|Inkscape]] an. Eine einfache Methode, neue Bilder zu erstellen ist, sich eine Bitmap-Grafik als Basis zu nehmen und in ein SVG zu konvertieren. Dazu verwende ich immer [[https://convertio.co/de/|https://convertio.co/de/]].  BMP zu SVG: [[https://convertio.co/de/bmp-svg/]] Manchmal werden so gewandelte SVG in Inkscape nicht korrekt dargestellt. Dann kann man versuchen, sie nach EPS und zurück zu wandeln: [[https://convertio.co/de/svg-eps/]] sowie [[https://convertio.co/de/eps-svg/]] ===== Eigene Icons einreichen ===== Gern können eigene Symbole an mich gesendet werden, damit ich sie ins Plugin aufnehme. Hierbei bitte Copyrights beachten, wenn es sich nicht um eigene Symbole handelt! Lizenzpflichtige Symbole kann ich nicht nicht verwenden. Bitte nur "lizenzfreie" Symbole einsenden.  Die eMail Adresse ist {{plugins:icon_watchdog:1269958890.png?200}} ===== Besonderheit, wenn man schon eigene Symbole gemalt hat ===== Wenn man schon eigene Symbole in der Loxone Config gezeichnet hat, werden diese als Pixelgrafiken / Bitmaps gespeichert. Diese haben den Nachteil, dass sie eine unschöne Auflösung und Detailgenauigkeit haben. Wenn man die Symbole nun direkt gegen SVG Dateien austauschen will, muss die Bitmap-Information aus dem Loxone Projekt entfernt werden. Dazu lädt man das aktuelle Programm aus dem Miniserver in die Loxone Config und speichert es auf dem lokalen Rechner ab. Diese Datei wird dann in das Plugin importiert. Nach dem Import gibt es einen Link zum Herunterladen des konvertierten Projekts: Dieses konvertierte Projekt muss man nun wieder in der Loxone Config laden und in den Miniserver zurückspeichern. Diese Schritte sind nur nötig, wenn man im Symbol-Editor der Loxone Config etwas gemalt hat. ===== Roadmap ===== In einer dieser ersten Version gibt es erstmal nur wenige Symbole, es ist jedoch geplant, weitere Symbole durch Plugin Updates zur Verfügung zu stellen. ===== Fragen stellen und Fehler melden ===== Bitte Fehler direkt als [[https://github.com/Woersty/LoxBerry-Plugin-Icon-Watchdog/issues/new|Issues in GitHub]] melden oder wenn du keinen eigenen Zugang hast, im Forum melden, ich mache dann gegebenenfalls einen Fehlerbericht daraus. ===== Known issues / Bekannte Probleme ===== Leider gibt es ein paar Probleme, wenn man Symbole welche schon in der App verwendet wurden ändert. Durch die Caching Funktionalität kommt es hier zu falschen Darstellungen von alten Symbolen. Im Browser hilft es, den Cache zu löschen, bei der App, kann eine Neuinstallation der App helfen, falls das Neuanlegen des Miniservers nicht reicht. Eine andere Möglichkeit ist, ein neues Symbol in der Loxone Config zu erstellen und dies dann zuzuordnen. Das Plugin startet den Miniserver **ungefragt** neu, wenn beim Klicken auf {{plugins:icon_watchdog:1269958882.png?100}} eine Änderung an der ''%%images.zip%%'' festgestellt wird. Das kann durch Hinzufügen eigener Symbole oder durch ein vorheriges Miniserver Update der Fall sein. Es läuft außerdem um 20 Uhr ein täglicher Zeitjob, der die images.zip prüft. Diese Reboots werden als "Manuelle Neustarts" in der Loxone App dargestellt.