Automatic Feeder Widgets

Vis-2 Widgets für den automatischen Futterautomaten

Vorgefertigte vis-2 Dashboard-Widgets für den ioBroker.automatic-feeder-Adapter - Drag-and-Drop-Karten für einen Fisch-/Koi-/Teichfutterautomaten. **Es müssen keine Objekt-IDs nachgeschlagen und kein HTML-Code geschrieben werden: Sie wählen Ihre Futterautomateninstanz und Ihren Futterschalter anhand ihres aussagekräftigen Namens aus einem Dropdown-Menü aus, und jedes Widget liest und steuert die richtigen Datenpunkte selbstständig.

Dieses Paket enthält sechs Widgets, die zusammen ein komplettes Fütterungs-Dashboard bilden. Das dunkle, tabletfreundliche Kartendesign verfügt über eine Akzentfarbe, die Sie ändern können. Vier Widgets zeigen lediglich Daten an; zwei ermöglichen Ihnen zusätzlich Aktionen (z. B. eine einmalige Fütterung auslösen oder die Fütterung pausieren).

Dies ist lediglich die Visualisierungsebene. Die gesamte Zeitplanung, das Temperaturmodell, die Sonnenaufgangs-/Sonnenuntergangslogik, Pausen und Benachrichtigungen befinden sich im separaten ioBroker.automatic-feeder-Adapter. Diese Widgets bieten eine Live-Ansicht und Fernsteuerung für diesen Adapter. (In der umfassenderen Smart-Pond-Familie kann beispielsweise der zugehörige Teichbelüftungs-Adapter die Belüftung pausieren, während der Futterautomat arbeitet - dies wird jedoch dort konfiguriert, nicht hier.)

Dieses Dokument ist ein vollständiges Handbuch. Falls Sie diese Widgets noch nie verwendet haben, lesen Sie es bitte von oben bis unten: Die Schnellstartanleitung zeigt Ihnen, wie Sie in etwa einer Minute eine funktionierende Karte erstellen, und der Rest erklärt jedes Widget und jede Option im Detail.

🇩🇪 Deutsche Anleitung: doc/de/README.md · andere Sprachen: siehe > Dokumentation unten.

Inhaltsverzeichnis

3. Anforderungen
4. Installation

• 6.1 FeederStatus
  • 6.6 AnimatedFeeder

9. Entwicklung

1. Was sind Vis-2-Widgets?

vis-2 ist das moderne Visualisierungstool von ioBroker (der Nachfolger des klassischen vis 1). Sie erstellen Dashboards („Ansichten“), indem Sie Widgets - Schaltflächen, Anzeigen, Karten - auf eine Arbeitsfläche ziehen und diese mit den Zuständen Ihres Geräts verbinden.

Normalerweise verknüpft man ein Widget manuell mit einem Zustand: Man sucht eine Objekt-ID (etwa automatic-feeder.0.switches.sw-0.status.feedingActive) und gibt sie in ein Bindungsfeld ein. Das funktioniert gut für einen einzelnen Wert, aber eine gute Feeder-Karte benötigt ein Dutzend solcher Widgets, die zusammenarbeiten.

Ein Widget-Set wie dieses löst das Problem: Es handelt sich um ein Add-on mit speziell entwickelten Widgets für einen Adapter. Jedes Widget kennt bereits die benötigten Zustände. Sie müssen lediglich den zu verwendenden Feeder angeben - alles andere ist bereits vorkonfiguriert. Anstatt also ein Dutzend manueller Bindungen vorzunehmen, genügen zwei Klicks (Instanz auswählen + Schalter) und Sie erhalten eine fertige Karte.

2. Was Sie erhalten

Sechs Widgets. Jedes ist eine in sich abgeschlossene Karte; Sie können nur eines verwenden oder sie zu einem vollständigen Dashboard kombinieren.

Die beiden "Schreib"-Widgets (FeedControl, AnimatedFeeder) schreiben nur, wenn Sie darauf klicken/tippen - von selbst ändert sich nichts.

In der Widget-Palette vis-2 erscheint das gesamte Set unter dem Gruppennamen Automatischer Futterautomat.

3. Anforderungen

• ioBroker mit installiertem vis-2 (dem modernen vis). Dies sind vis-2-Widgets und funktionieren nicht in der klassischen Version.

vis 1.

• Der ioBroker.automatic-feeder-Adapter, installiert und konfiguriert mit mindestens einem Switch (ein "Switch" ist ein

Zuführung in der Adapterkonfiguration; sie hat einen aussagekräftigen Namen wie z. B. KoiTeich Ponton). Empfohlene Adapterversionen:

• Version 1.4.0 oder neuer - erforderlich für die numerischen Zeitstempel, den Befehl blockReasonCode und den Befehl feedFor

Widgets sind darauf angewiesen.

• Version 1.5.0 oder neuer - empfohlen, aktiviert zusätzlich den Live-Laufzeit-Countdown in FeederStatus

(der Datenpunkt status.feedingEndsTs).

• Version 1.6.0 oder neuer - empfohlen für den exakten Countdown-Ring in AnimatedFeeder (der

status.feedingDurationSec Datenpunkt).

Sie müssen niemals eine Objekt-ID manuell eingeben: Die Widgets lesen und schreiben nur die eigenen status.* und settings.* Datenpunkte des ausgewählten Schalters, die aus der von Ihnen ausgewählten Instanz und dem Schalter ermittelt werden.

4. Installation

1. Installieren Sie ioBroker.vis-2-widgets-automatic-feeder in ioBroker - aus der Admin-Liste Adapter, sobald es installiert ist.

aus dem Repository oder direkt von GitHub / npm. Es wird als visualization-widgets-Adapter installiert (onlyWWW, es wird keine laufende Instanz erstellt).

2. Öffnen Sie vis-2. In der Widget-Palette (linke Seite, im Bearbeitungsmodus) erscheint eine neue Widget-Gruppe Automatischer Futterautomat.

Modus).

3. Ziehen Sie ein beliebiges Widget auf eine Ansicht - siehe die Schnellstartanleitung unten.

Nach jedem Update: Führen Sie iobroker upload vis-2-widgets-automatic-feeder aus, starten Sie anschließend vis-2 neu (die Installation des Adapters veranlasst vis-2 bereits zu einem Neustart) und führen Sie ein vollständiges Neuladen (Strg+F5) im Browser durch, damit der Runner das neue Widget-Bundle erkennt. Siehe Fehlerbehebung.

5. Schnellstart

1. Wechseln Sie in vis-2 in den Bearbeitungsmodus, öffnen Sie eine Ansicht und ziehen Sie das Widget FeederStatus aus dem Automatischen Futterautomaten.

Gruppe darauf.

2. Wählen Sie das Widget aus, öffnen Sie das Attribute-Panel auf der rechten Seite und füllen Sie die beiden Felder im allgemeinen Bereich aus.

Gruppe:

• Feeder-Instanz - Wählen Sie Ihre automatic-feeder-Instanz aus (normalerweise 0; dies ist eine Standard-Instanzauswahl).
• Schalter - Wählen Sie Ihren Zuleiter aus dem Dropdown-Menü. Dort werden Ihre konfigurierten Schalter mit ihrem Anzeigenamen aufgelistet.

(z.B. KoiTeich Ponton), direkt aus der Konfiguration des Adapters ausgelesen.

3. Die Karte zeigt sofort Live-Daten an. Wiederholen Sie dies für jedes andere Widget - die Instanz-/Schalterauswahl funktioniert genau so.

Gleiches gilt für alle sechs.

Das ist alles: keine Objekt-IDs, keine manuellen Bindungen, keine Skripte. Solange nicht beide Felder ausgefüllt sind, zeigt ein Widget anstelle von Daten den hilfreichen Hinweis „Wählen Sie den Zuleitungsschalterkanal in den Widget-Einstellungen aus.“ an.

6. Die Widgets im Detail

Alle Widgets benötigen dieselben zwei Einstellungen - Futteranlage und Schalter - in der gemeinsamen Attributgruppe (siehe Konfiguration & Bindungen). Die Darstellungsoptionen der einzelnen Widgets sind unten aufgeführt. Alle Screenshots zeigen Live-Daten eines echten Koiteich-Futterautomaten.

6.1 FeederStatus

Die Hauptkarte. Von oben nach unten zeigt sie:

• Eine Statusanzeige: Bereit (grün) oder Blockiert (gelb). „Blockiert“ bedeutet, dass der Adapter derzeit nicht berechtigt ist,

Fütterung (Nacht, Temperatur zu niedrig, Sauerstoffgehalt zu niedrig, eine Pause …).

• Eine animierte Zuführungsgrafik. Während der Zuführung läuft, dreht sich der Lüfter und - mit Adapter v1.5.0+ - eine Laufzeit.

Daneben erscheint ein Countdown** (z. B. 5 s), der bis zum Ende der aktuellen Fütterung herunterzählt.

• Die nächste Fütterung: ein langer Countdown (in ca. 27 Minuten, oder 1 Stunde 05 Minuten nach der vollen Stunde), die genaue Uhrzeit und die

Modus (dynamisches Intervall, wenn dynamische Fütterung aktiviert ist, ansonsten Zeitplan).

• Die letzte Fütterung mit einem ✓ (Erfolg, grün) oder ✗ (Fehler, rot) Markierung und dem Ergebnis des Adapters.
• Das astronomische Fenster (Sonnenaufgang - Sonnenuntergang), das für die Tag/Nacht-Logik verwendet wird.
• Im Falle einer Blockierung wird eine zusätzliche Grund-Zeile mit dem für Menschen lesbaren Blockierungsgrund (in Gelb) angezeigt.

Die Karte wird einmal pro Sekunde neu gerendert, damit die Countdowns aktiv bleiben.

Darstellungsoptionen (Gruppe Darstellung):

Standard-Widgetgröße: 320 × 340 px.

6.2 Zuführungskontrolle

Die Kontrollkarte:

• Jetzt füttern - eine zweistufige Schaltfläche. Der erste Klick aktiviert sie und die Beschriftung ändert sich zu Bestätigen: N s ?; die

Ein zweiter Klick löst genau eine Fütterung der gewählten Dauer aus und zeigt kurz Ausgelöst ✓ an. Wenn Sie nicht innerhalb von ca. 4 Sekunden bestätigen, deaktiviert sich das Gerät automatisch.

• Portion (manuell) - ein Schieberegler, der die Fütterungsdauer in Sekunden von 1 bis zur Maximalen Dauer einstellt (Standardwert).

(beginnt bei 5 Sekunden).

• Stromzufuhr unterbrechen - ein Hauptschalter, der die gesamte Stromzufuhr für diesen Schalter sofort unterbricht, bis er betätigt wird.

Zurücktreten. Es schreibt den settings.pauseNow des Adapters, der jeden Modus und jede zeitbasierte Pause überschreibt.

Darstellungsoptionen (Gruppe Darstellung):

Standard-Widgetgröße: 300 × 240 px.

Die Schaltfläche sendet einen einmaligen Datenstrom über den Adapterbefehl feedFor (Wert = Dauer in Sekunden). Ihr Zeitplan wird dadurch nicht geändert und der Adapter wird nicht neu gestartet.

6.3 Umgebung

Die Wasser-/Umweltkarte:

• Wassertemperaturen im Flachwasserbereich und im Tiefwasserbereich** (in °C, gerundet auf 0,1). Die Kachel für den Tiefwasserbereich bleibt auf „-“, wenn Sie nicht …

Konfigurieren Sie einen zweiten, tiefer liegenden Sensor.

• Eine Schichtungspille, die die Differenz Δ zwischen den beiden Schichten (in K) anzeigt. Sie färbt sich bernsteinfarben, wenn die Schichten

Sie unterscheiden sich um mehr als 3 K.

• Eine O₂-Tablette in mg/l - wird nur angezeigt, wenn ein Sauerstoffsensor konfiguriert ist, und färbt sich rot, wenn der Wert sinkt.

unterhalb des konfigurierten Minimums (settings.o2Min).

• Ein Tagesbalken von Sonnenaufgang (☀) bis Sonnenuntergang (☾) mit einer Live-Markierung für die aktuelle Uhrzeit (wird jede Minute neu berechnet).

Darstellungsoptionen (Gruppe Darstellung):

Standard-Widgetgröße: 320 × 220 px.

6.4 Dynamische Zuführung

Zeigt das Q10-Temperaturmodell, das der Adapter zur Anpassung der Zufuhr an die Wassertemperatur verwendet. Vier Kacheln:

• Durchschnittstemperatur - die durchschnittliche Temperatur, auf der das Modell basiert (°C).
• Rate (Q10) - der resultierende Ratenfaktor (× relativ zur Referenztemperatur).
• Intervall - das sich daraus ergebende Fütterungsintervall in Minuten.
• Portion - die daraus resultierende Fütterungsdauer in Sekunden.

Eine Quellen-Pille in der Kopfzeile zeigt an, ob das Modell vom Wassersensor (flach) oder vom Luftsensor (settings.dynamicSource) gesteuert wird. Wenn die dynamische Zufuhr für diesen Schalter deaktiviert ist, zeigt die Karte anstelle der Kacheln den Hinweis "Dynamische Zufuhr ist für diesen Schalter deaktiviert." an.

Darstellungsoptionen (Gruppe Darstellung):

Standard-Widgetgröße: 460 × 150 px.

6.5 Saisonbanner

Eine einzelne, farbcodierte Statuszeile - ideal für den oberen Bereich einer Ansicht. Sie zeigt stets den wichtigsten aktuellen Status in dieser Prioritätsreihenfolge an:

1. Manuelle Pause (rot) - der Hauptpausenschalter (status.pauseManual) ist eingeschaltet.
2. Zeitbasierte Pause (gelb) - ein konfiguriertes Pausenfenster ist aktiv (status.pauseActive), mit seiner Endzeit

angehängt (status.pauseActiveUntil).

3. Winterpause (blau) - das Winterfenster ist aktiv (status.winterActive).
4. Automatisch aktiv (grün) - nichts blockiert die Fütterung, der Zeitplan läuft normal ab.

Dieses Widget bietet keine weiteren Darstellungsoptionen außer den beiden Standardeinstellungen (Instanz + Schalter).

Standard-Widgetgröße: 460 × 44 px.

6.6 AnimatedFeeder

Ein großer, animierter Futterautomat, dargestellt auf einer HTML-Seite (<canvas>) - das visuelle Herzstück eines Teich-Dashboards. Er reagiert live auf den Schalter:

• Während der Fütterung: Futterpellets fallen aus dem Auslass und ein Countdown-Ring mit den verbleibenden Sekunden füllt sich.

Der Ring ist exakt, wenn der Adapter status.feedingDurationSec (v1.6.0+) bereitstellt; bei älteren Adaptern wird die Gesamtdauer ab dem Zeitpunkt des Fütterungsbeginns berechnet.

• Pause-Zustände, dargestellt als Symbol auf einer Scheibe mit einem roten Kreuz, mit der gleichen Priorität wie das Saisonbanner:

Manuelle Pause (Hand) → Zeitbasierte Pause (Uhr) → Winterpause (Schneeflocke).

• Leerlauf: Nur der Futterautomat, mit einem optionalen „Zum Füttern tippen“-Hinweis.

Tippen zum Füttern: Tippen Sie einmal auf das Widget, um es zu aktivieren (Bestätigen: N s ?). Tippen Sie erneut, um eine einmalige Fütterung der konfigurierten Dauer auszulösen (über feedFor). Während einer Pause oder einer laufenden Fütterung wird das Tippen ignoriert. Die gesamte Funktion kann mit Tippen zum Füttern aktivieren deaktiviert werden. (Die Animation des fallenden Pellets wird automatisch reduziert, wenn das Betriebssystem weniger Bewegung anfordert.)

Optionen - der AnimatedFeeder verfügt über drei Attributgruppen:

Verhalten:

Aussehen:

Geometrie - Die Positionen sind in % des Widgets angegeben, sodass die Animation ausgerichtet werden kann, wenn Sie Ihr eigenes Bild verwenden:

Standard-Widgetgröße: 300 × 440 px.

6.7 Fütterungsmenge

Eine kompakte, schreibgeschützte Karte für das Futtermengenmodell des Adapters (automatischer Futterautomat v1.16.0+) mit einem Schalter. Sie zeigt die empfohlene Tagesration in Gramm, den Fütterungsprozentsatz für die aktuelle Wassertemperatur und das geschätzte Gesamtgewicht der Fische an. Im Steuerungsmodus (Phase B) werden zusätzlich die Portion pro Fütterung, die Fütterungsdauer und die tägliche Laufzeit sowie der Name des aktiven Fütterungsprofils angezeigt. Die genauen Werte pro Fütterung stammen aus den Adaptereinstellungen status.feedTargetPortionGrams / status.feedingsPerDayToday; ältere Adapter verwenden einen abgeleiteten Wert.

Eine Schaltfläche in der Kopfzeile zeigt an, ob das Modell beratend (Phase A) oder fütterungssteuernd (Phase B) ist. Um das Modell zu bearbeiten (Fischanzahl, Temperaturprozentsätze, Fütterungsprofil, Phasenwechsel, Tageshöchstmenge), verwenden Sie das separate Widget FeedingAmountSettings weiter unten.

Darstellung: Akzentfarbe (Standard #f2a63c) und Kein Kartenhintergrund. Standard-Widget-Größe: 460 × 190 px.

6.8 Einstellungen für die Fütterungsmenge

Der Editor für das Modell „Zufuhrmenge“ - ein Bedienfeld mit Lichteinstellungen, das direkt in die beschreibbaren Zustände switches.<id>.settings.* des Adapters schreibt (benötigt automatic-feeder v1.16.0+ für die Spiegelung der Einstellungen und v1.17.0+ für den Zufuhrprofil-Umschalter). Verwenden Sie ihn auf einem Dashboard neben der schreibgeschützten Karte FeedingAmount.

Es bietet:

• ein Modell Ein/Aus-Schalter (amountModelEnabled);
• eine Fischliste mit einem Symbol pro Größe, dem festgelegten Referenzgewicht und einer bearbeitbaren Anzahl für jede Größenklasse

(15/20/30/40/50/60 cm), mit einem Lebendgewicht von Gesamtgewicht;

• ein aktiver Feed-Umschalter, der aus den Feed-Profilen erstellt wurde, die Sie für den Umschalter in der Adapterverwaltung definiert haben - ein Tippen genügt

Wählt das aktive Profil aus (schreibt settings.activeFeed) und dessen Dosierrate (g/s) steuert den Steuermodus;

• die sieben Temperaturprozentsätze (<15° … >30°);
• ein Ein-/Ausschalter (Phase B) und, wenn eingeschaltet, die optionale Tageshöchstmenge in Gramm.

Jedes Feld im Widget wird sofort aktualisiert und an den Adapter geschrieben, der die Aktualisierung anwendet und die Instanz neu startet (kurze Entprellzeit), damit das Modell neu berechnet wird. Das Panel verwendet den vis-2-Farbmodus (dunkel/hell). Standard-Widget-Größe: 470 × 620 Pixel.

7. Konfiguration & Bindungen

Jedes Widget verfügt über die gleichen zwei erforderlichen Einstellungen in der gemeinsamen Attributgruppe:

• Feeder-Instanz - Wählen Sie Ihre „automatische-Feeder“-Instanz aus dem Dropdown-Menü (normalerweise „0“). Akzeptiert entweder die

einfache Zahl (0) oder die Langform (automatic-feeder.0).

• Schalter - Wählen Sie den Feeder aus einer Dropdown-Liste, die Ihre konfigurierten Schalter mit ihrem Anzeigenamen auflistet (z. B.

KoiTeich Ponton), nicht über eine interne ID. Die Liste wird aus der Konfiguration der ausgewählten Instanz gelesen (system.adapter.automatic-feeder.<instance> → native.switches[]).

Aus diesen beiden Werten erstellt das Widget den Schaltkanal automatic-feeder.<instance>.switches.<switch> und abonniert die benötigten Unterzustände - Sie müssen die Bindung nicht selbst eingeben. Solange nicht beide Felder gesetzt sind, zeigt das Widget anstelle der Daten den Hinweis "Wählen Sie den Zuleitungs-Schaltkanal aus…" an.

Die optionalen Darstellungseinstellungen befinden sich in der Gruppe Darstellung jedes Widgets (und beim AnimatedFeeder zusätzlich in Verhalten und Geometrie); siehe die einzelnen Widgets oben. Gemeinsame Optionen für alle Widgets:

8. Welche Datenpunkte jedes Widget verwendet

Aus Gründen der vollständigen Transparenz: Die Widgets abonnieren den Schaltkanal automatic-feeder.<instance>.switches.<switch>.… und verwenden ausschließlich diese relativen Datenpunkte:

Die genaue Bedeutung der einzelnen Datenpunkte finden Sie im Abschnitt ioBroker.automatic-feeder-Dokumentation.

9. Entwicklung

Die Widgets sind in TypeScript + React 18 (mit MUI für die Attribut-Editoren) geschrieben und zusammen mit Vite und Module Federation in einem einzigen customWidgets.js gebündelt, das vis-2 zur Laufzeit lädt. Der Quellcode befindet sich in src-widgets-ts/src/:

Das Widget-Set ist in io-package.json unter common.visWidgets.vis2AutomaticFeeder registriert (Komponenten FeederStatus, FeedControl, Environment, DynamicFeeding, SeasonBanner, AnimatedFeeder).

Build & Skripte (vom Stammverzeichnis des Repositorys ausführen):

npm run npm      # install root + src-widgets-ts dependencies
npm run build    # build the TypeScript widgets → widgets/vis-2-widgets-automatic-feeder/
npm run lint     # ESLint over src-widgets-ts
npm test         # @iobroker/testing package tests (mocha test/package)

npm run build führt node tasks --typescript aus, welches die Bereinigung durchführt, src-widgets-ts mit Vite erstellt und customWidgets.js, die Assets, Bilder und das Icon-Set, in widgets/vis-2-widgets-automatic-feeder/ kopiert (der Ordner, der an Endbenutzer ausgeliefert wird; main verweist auf customWidgets.js). Releases werden mit @alcalzone/release-script (npm run release-patch / -minor / -major) erstellt, welches den Build ebenfalls vor dem Commit ausführt.

10. Fehlerbehebung & Häufig gestellte Fragen

Ein Widget zeigt lediglich „Wählen Sie den Zuleitungsschalterkanal…“ an. Legen Sie beide gemeinsamen Felder (Instanz und Schalter) fest. Die Dropdown-Liste des Schalters wird mit den Daten der ausgewählten Instanz gefüllt. Wählen Sie daher zuerst die Instanz aus.

Das Dropdown-Menü für die Schalter ist leer. Die ausgewählte Instanz automatic-feeder verfügt noch über keine konfigurierten Schalter, oder die Instanznummer ist falsch. Konfigurieren Sie zuerst einen Schalter im Adapter.

Die Werte zeigen – an. Stellen Sie sicher, dass der Adapter Version 1.4.0 oder neuer ist (Version 1.5.0+ für den Laufzeit-Countdown). Ältere Versionen liefern nicht die numerischen Zeitstempel und Befehlsdatenpunkte, auf die die Widgets angewiesen sind. Die Kachel Wassertiefe zeigt weiterhin – an, sofern Sie keinen zweiten, tieferen Sensor konfiguriert haben; die O₂-Pille ist ausgeblendet, sofern kein Sauerstoffsensor konfiguriert ist - beides ist normal.

Der Laufzeit-Countdown wird nie angezeigt. Er benötigt den Adapter v1.5.0+ (status.feedingEndsTs) und wird nur während eines laufenden Fütterungsvorgangs angezeigt.

Der Countdown-Ring von AnimatedFeeder ist nicht exakt proportional. Für einen exakten Ring wird der Adapter v1.6.0+ (status.feedingDurationSec) benötigt; bei älteren Adaptern wird die Dauer anhand des Fütterungsbeginns geschätzt, daher ist der Ring nur annähernd.

Neue/aktualisierte Widgets werden nicht angezeigt oder nur teilweise. Dies liegt fast immer an einem veralteten Widget-Paket im Browser/Runner. Führen Sie iobroker upload vis-2-widgets-automatic-feeder aus, starten Sie vis-2 (oder den Host) neu und aktualisieren Sie den Browser (Strg+F5).

Ersetzt dies den Adapter? Nein. Es handelt sich hierbei lediglich um Dashboard-Widgets. Die gesamte Zeitplanung, Temperaturlogik, Pausen und Benachrichtigungen werden im ioBroker.automatic-feeder-Adapter gesteuert; die Widgets bieten lediglich eine Ansicht und eine Fernbedienung dafür.

Dokumentation

• 🇩🇪 Deutsche Dokumentation
• 🇷🇺 Dokumente auf Russisch
• 🇳🇱 Nederlandse documentatie
• 🇫🇷 Documentation française
• 🇮🇹 Italienische Dokumentation
• 🇪🇸 Dokumentation auf Spanisch
• 🇵🇱 Polnische Dokumentation
• 🇵🇹 Portugiesische Dokumentation
• 🇺🇦 Документація українською
• 🇨🇳 简体中文文档

Changelog

0.4.4 (2026-09-06)

• (ssbingo) Maintenance: dependency and build-tooling updates (@iobroker/adapter-react-v5 8.3.3, @iobroker/types-vis-2 2.15.4, @module-federation/vite 1.21.1). No widget changes

0.4.3 (2026-09-01)

• (ssbingo) FeedingAmountSettings now selects the active feed from the adapter's central feed list (native.feeds) via a dropdown, written id-based to settings.activeFeed — replacing the deprecated per-switch feed profiles (needs automatic-feeder v1.18.0+). FeedingAmount additionally shows the active feed's pellet size (status.activeFeedSize)

0.4.2 (2026-09-01)

• (ssbingo) FeedingAmountSettings now has an Accent colour option (Appearance group), just like the FeedingAmount widget — the accent drives the toggles, active borders and highlighted values, so both widgets can be given the same accent for a consistent design. In light mode the accent is darkened for readable text; in dark mode it is used directly

0.4.1 (2026-09-01)

• (ssbingo) FeedingAmountSettings now follows the vis-2 colour mode (dark/light) like the other widgets — it reads context.themeType and renders a dark panel in dark mode and the light panel in light mode (previously it was always light)
• (ssbingo) The No card background option of FeedingAmountSettings now actually works (transparent background) instead of doing nothing

0.4.0 (2026-09-01)

• (ssbingo) New separate FeedingAmountSettings widget — a light settings panel matching the agreed design: a model on/off switch, a fish list with per-size icons + reference weights and editable counts (with a live total weight), the seven temperature percentages, a Phase-B control switch and the optional daily maximum. All fields write to the adapter's writable switches.<id>.settings.* states (automatic-feeder v1.16.0+)
• (ssbingo) FeedingAmountSettings has an active-feed switcher built from the feed profiles configured for the switch in the adapter admin; one tap selects the active profile and its dispense rate (writes settings.activeFeed, needs automatic-feeder v1.17.0+)
• (ssbingo) The FeedingAmount widget is now purely a read-only display card again; all editing moved to the new FeedingAmountSettings widget. It also shows the active feed-profile name (status.activeFeedName)

0.3.2 (2026-09-01)

• (ssbingo) Housekeeping: keep only the latest 7 entries in common.news (repository checker W1032). No widget changes

0.3.1 (2026-09-01)

• (ssbingo) Housekeeping (repository checker): bumped @alcalzone/release-script-plugin-license to 5.2.2 (S0064), removed the unneeded prepublishOnly script (W0095) and the unnecessary admin dependency — this is a pure widget set with no admin config UI (S1091) — and unpinned the CI deploy action to @v1 (S3044). No widget changes

0.3.0 (2026-09-01)

• (ssbingo) New widget FeedingAmount: shows the adapter's feeding-amount model for a switch — recommended daily ration, the feeding percentage for the current water temperature, estimated total weight and, in control mode, the per-feeding portion and motor run-times. It uses the adapter's status.feedTargetPortionGrams / status.feedingsPerDayToday for an exact per-feeding amount (automatic-feeder v1.16.0+)
• (ssbingo) The FeedingAmount widget is editable: an Edit toggle lets you change the fish counts, the temperature percentages, the Phase-A/B switches and the dispense rate; the changes are written to the adapter's writable switches.<id>.settings.* states (needs automatic-feeder v1.16.0+ for the amount-model settings mirror)

0.2.1 (2026-07-07)

• (ssbingo) Fixed AnimatedFeeder showing nothing in Firefox: the built-in feeder image now uses a base64 data URI (Firefox rejects the non-standard ;utf8, form that Chrome tolerated) and the canvas 2D context is initialised from the <canvas> ref callback, so it binds reliably regardless of mount order. A failed or zero-size custom image can no longer blank the whole widget

0.2.0 (2026-07-07)

• (ssbingo) New sixth widget AnimatedFeeder: a large animated feeder (canvas) with falling pellets, a countdown ring and pause symbols (manual / time-based / winter); tap it to trigger a one-off feeding. The exact countdown ring uses the adapter's new status.feedingDurationSec (automatic-feeder v1.6.0+)
• (ssbingo) New stylized adapter and widget-set icon (feeder on a light grey tile)

License

MIT License

Copyright (c) 2026 ssbingo silvio.sternitzke@googlemail.com

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.