Slideshow for VIS from different sources
npm install iobroker.slideshow!Logo


!Number of Installations (latest)
!Number of Installations (stable)
!Test and Release


!Demo
Folgende Quellen stehen aktuell zur Verfügung:
* Die letzten acht täglichen Bilder von Bing.com
* Via VIS-Dateimanager hochgeladene Bilder
* Bilder aus beliebigem Pfad im Dateisystem
* Bilder von Synology PhotoStation und Synology Photo
Zur Darstellung in VIS stellt der Adapter ein Widget zur Verfügung.
Dieses bietet auch Funktionen für Effekt beim Bildwechsel, beispielsweise sanftes Ein- und Ausblenden.
Zusätzlich kann ein Timeout eingestellt werden. Sofern auf anderen View im Projekt keine Aktion für das eingestellte Timeout erfolgt ist,
wird zur View mit der Diashow gewechselt. Durck Klicken des Bilds wird entweder zurück zur letzten Ansicht oder zu einer eingestellten Ansicht gewechselt.
Neben dem Bild selbst als Pfad oder Base64-kodiertes Objekt werden weitere Objekte mit Informationen zum Bild in ioBroker erstellt.
Diese sind abhängig von der ausgewählten Quelle:
| Objekt | Bing | Lokal und Dateisystem | Synology
| ----------- | ----------- | ----------- | -----------
| info1 | Titel | Titel (EXIF-Information) | Titel
| info2 | Beschreibung | Betreff (EXIF-Information) | Beschreibung
| info3 | Copyright-Informationen | Kommentar (EXIF-Information) | Dateiname
| date | Datum der Anzeige auf Bing-Seite | Aufnahmedatum (EXIF-Information) | Aufnahmedatum
Der Button "updatepicturelist" als Objekt in ioBroker liest die Bilder aus den konfigurierten Quellen neu ein, z.B. nach Hinzufügen oder Löschen von Bildern. Die Bilder aus allen Quellen mit Ausnahme Bing werden sonst nur beim Start des Adapters eingelesen. Bing-Bilder werden stündlich automatisch aktualisiert.
Dieser Adapter verwendet die Sentry Bibliotheken um automatisch Abstürze und Programmfehler an die Entwickler zu übermitteln.
Weitere Details und für Informationen zur Deaktivierung der Fehlerberichterstattung in der Sentry-Plugin Dokumentation! Sentry Reporting wird ab JS-Controller 3.0 verwendet.
Bei Auswahl der Quelle "Dateisystem" kann dann noch der Pfad im Dateisystem ausgewählt werden, außerdem das Format (Hoch- oder Querformat) der anzuzeigenden Bilder sowie die Reihenfolge.
Bei Auswahl der Quelle "Synology PhotoStation" muss die DSM-Version, die IP-Adresse oder der Hostname sowie Benutzername und Passwort angegeben werden. Download von Bildern durch Benutzer muss in den Einstellungen von PhotoStation aktiviert sein.
Das Widget sollte in eine eigene View integriert werden. Hierdurch lässt sich der automatische Start der Diashow nutzen.
Folgende Einstellungen sind möglich:
* Abschnitt "Allgemein"
* Object-ID: Hier muss der vom Adapter erzeugte Datenpunkt ausgewählt werden, beispielsweise "slideshow.0.picture"
* Widget mit Bild füllen
* True (Standard) = Bild füllt das Widget, der Bildrand ist möglicherweise abgeschnitten
* False = Das vollständige Bild wird angezeigt, das Widget kann jedoch leere Zonen haben
* Abschnitt "Effekt"
* SlideshowEffect: Als Effekt kann zwischen folgenden gewählt werden:
* "Kein"
* "Fade": Einfaches Verblassen und Erscheinen
* "Transition": Überblenden
* "jQuery-Effekt": Diverse jQuery-Effekte, beispielsweise Rolladen
* Übergangsphase: Zeit in Millisekunden für den Effekt, gute Werte sind 500 oder 1000ms
* Transition Style: Stil für "Transistion" und "jQuery-Effekt"
* jQuery-Effekt: Gewünschter jQuery-Effekt
* Abschnitt "Automatischer Diashow-Start"
* Aktivierung des automatischen Starts
* Timeout: Nach welcher Zeit ohne Aktion auf die Diashow-View gewechselt wird
* Ziel beim Klicken:
* Zuletzt verwendete Ansicht
* Konfigurierte Ansicht (siehe nächster Einstellung)
* Kein, falls beispielsweise ein eigener Button integriert werden soll
* Zielansicht: Aufzurufende Ansicht beim Verlassen der Diashow
Quelle Dateisystem
Können Netzlaufwerke eingebunden werden?
Ja, aber nicht direkt durch den Adapter. ioBroker unterstützt mittlerweile sehr viele Betriebssysteme. Der Zugriff und das Verbinden von Netzwerkfreigaben ist je nach Betriebssystem komplett unterschiedlich. Teilweise werden auch weitere Komponenten wie z.B. Samba bei Linux benötigt. Das Verbinden des Netzlaufwerks (Mappen bzw. Mount) kann aber direkt über das Betriebssystem durchgeführt werden. Unter Linux erfolgt der Mount in ein angegebenes Verzeichnis, z.B. /mnt/pictures. Dieses Verzeichnis kann dann in der Adapter-Konfiguration verwendet werden.
Synology
Können für Synology PhotoStation weitere Einstellungen wie z.B. Auswahl des Albums integriert werden?
Der Zugriff auf bestimmte Fotoalben bzw. Ordner kann jedoch in der aktuellen Version von PhotoStation einfach realisiert werden. Hierzu unter DSM einen Benutzer für Slideshow anlegen und diesem Benutzer in der PhotoStation nur Berechtigungen auf die gewünschten Fotoalben bzw. Ordner geben.
The following Sources can actually be used:
* The last eight daily pictures from Bing.com
* Pictures uploaded by VIS-File-Manager
* Pictures from file system path
* Pictures from Synology PhotoStation or Synology Photo
The Adapter provides a Widget for Presentation in VIS, which offers effects on picture change, for example smooth fade-out and fade-in.
Additionally a timeout can be configured. When on other views in the same VIS project no actions for the defined timeout occured, the view with the Slideshow will be started. With a click on the picture it changes back to the last view or to a predefined view.
Beside the picture as path or Base64 encoded object are more objects with picture informations created in ioBroker.
These depend on the selected source:
| Object | Bing | Local and Filesystem | Synology
| ----------- | ----------- | ----------- | -----------
| info1 | Title | Title (EXIF information) | Title
| info2 | Description | Subject (EXIF information) | Description
| info3 | Copyright | Comment (EXIF information) | Dateiname
| date | Date shown on Bing page | Recording date (EXIF information) | Recording date
The button "updatepicturelist" as objekt in ioBroker re-reads the pictures from the configured source, usefull for example after adding or removing pictures from source. Pictures from all source, except Bing, are usually loaded on startup of the Adapter. Bing pictures are automatically updated hourly.
This adapter uses Sentry libraries to automatically report exceptions and code errors to the developers.
For more details and for information how to disable the error reporting see Sentry-Plugin Documentation! Sentry reporting is used starting with js-controller 3.0.
When source "File system" is selected, the path can be entered and the format (landscape or portrait) of the pictures to be shown. Also the order can be configured.
When source "Synology PhotoStation" is selected, the Synology DSM version, the IP address or hostname and an username with password has to be configured.
Attention: After changes (Adding or Deleting) a restart of the adapter is required.
The widget should be integrated in an own view, so the automatic start of the Slideshow can be used.
The following configuration options exist:
* Category "Common"
* Object-ID: The ioBroker object created by the adapter must be provided, for example "slideshow.0.picture"
* Fill widget with picture
* True (Default) = Picture fills widget, border of picture may be cut off
* False = Complete picture is shown, but widget may have empty zones
* Category "Effect"
* SlideshowEffect: The following options are available:
* "None"
* "Fade": Simple fade-out and fade-in
* "Transition": fade-over
* "jQuery-Effekt": Different jQuery effects, for example "blind"
* Transition period: Time in miliseconds for the effect, 500 or 1000 are recommended values
* Transition style: Style for "Transistion" und "jQuery-Effect"
* jQuery-Effect: Desired effect
* Category "Automatic Slideshow start"
* Enable automatic start
* Timeout: After which time in seconds of inactivity on other views the Slideshow will be started
* Target on click:
* Last used view
* Configured view (see next setting)
* None, for example when integrating another widget therefore
* Target view: View to show when leaving Slideshow
Source FileSystem
Can network drives be integrated?
Yes, but not directly through the adapter. ioBroker now supports a large number of operating systems. Accessing and connecting network shares is completely different depending on the operating system. In some cases, additional components such as Samba for Linux are also required. The connection of the network drive (mapping or mount) can be done directly by the operating system. Under Linux, the mount takes place in a specified directory, e.g. / mnt / pictures. This directory can then be used in the adapter configuration.
Copyright (c) 2024 Gaudes
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.