Aura

Aura ist ein modernes Visualisierungs-Dashboard für ioBroker .

📖 Dokumentation – Widgets, Einstellungen, Screenshots

Installation

Schritt 1 – Adapter installieren

Installieren Sie Aura über ioBroker Admin:

1. ioBroker-Admin öffnen
2. Gehe zu Adapter
3. Suche nach Aura und installiere es.

Schritt 2 – Instanz erstellen

Nach der Installation muss eine neue Aura- Instanz erstellt werden (falls dies nicht automatisch erfolgt).

Schritt 3 – Konfigurieren Sie die Instanz

Aura betreibt einen eigenen Webserver (Frontend + integrierter iFrame-Proxy) und verbindet sich mit einem bestehendeniobroker.web Diese Instanz dient ausschließlich der Socket.IO-Datenverbindung. Öffnen Sie die Aura -Instanzeinstellungen:

Voraussetzung: Ein laufender Computeriobroker.web (oderiobroker.socketio Die Socket.IO-Instanz muss auf dem konfigurierten Socket-Port funktionieren.web.0 Mit socket.io = integrated wird dies auf Port bereitgestellt8082 (Standardeinstellung). Aura erkennt die passende Instanz automatisch und leitet die Verbindung intern weiter, daher keine/aura/ Ein Pfad oder eine Web-Erweiterung ist nicht mehr erforderlich.

Schritt 4 – Dashboard öffnen

Das Dashboard ist hier verfügbar:

http://<iobroker-ip>:8095/

Die Administratoroberfläche unter:

http://<iobroker-ip>:8095/#/admin

HTTPS / Reverse-Proxy

Aura kann HTTPS auf zwei Arten bereitstellen.

Option A – Integriertes TLS

Aktivieren Sie HTTPS in den Aura-Instanzeinstellungen und wählen Sie die Zertifikate aus (geladen von ioBroker).system.certificates Auras eigener Server dient dannhttps://<iobroker-ip>:8095/ Die

Das standardmäßige selbstsignierte Zertifikat löst eine Browserwarnung aus. Für eine sichere Installation verwenden Sie gültige Zertifikate (z. B. Let's Encrypt) oder platzieren Sie Aura hinter einem Reverse-Proxy (Option B).

Option B – Umgekehrter Proxy

Richten Sie einen Reverse-Proxy (z. B. nginx , Nginx Proxy Manager , Caddy ) mit einem gültigen TLS-Zertifikat auf dem Port von Aura ein. Aura leitet die Socket.io-Verbindung intern an die Webinstanz weiter, daher genügt ein einziger weitergeleiteter Port.

Nginx Proxy Manager – Beispielkonfiguration

Alternative Topologie: Wenn Sie stattdessen einen Proxy verwenden/socket.io/ Und/echarts/ direkt zum Webadapter-Port, legen Sie die ioBroker-Socket-URL (Überschreiben) in den Aura-Einstellungen auf Ihre öffentliche URL fest (z. B.https://your-domain.com ) sodass das Frontend socket.io mit dem richtigen Endpunkt verbindet.

Fehler & Funktionswünsche

Bitte melden Sie das Problem direkt auf GitHub:

github.com/hdering/ioBroker.aura/issues

Versionierung

Aura verwendet ein einfaches Schema, sodass man stabile Versionen auf einen Blick von Testversionen unterscheiden kann:

• A -nextNDas Suffix kennzeichnet eine Vorabversion. Die Zahl gibt die Anzahl der Testversionen an, die zur nächsten regulären Version führen (next1 ,next2 , …). Vorabversionen werden in ioBroker nicht automatisch angeboten; Sie erhalten sie nur, wenn Sie diese Version explizit installieren.
• Eine einfache Zahl (0.10.1 ,0.10.2 , …) wird zuerst im Latest- Repository von ioBroker veröffentlicht. Dadurch ist es allgemein verfügbar, aber Latest dient als Testumgebung – ein Schritt vor der endgültigen Stabilität.
• Sobald eine neueste Version lange genug ohne Fehler gelaufen ist, wird sie in das Stable -Repository aufgenommen. Erst dann gilt sie als vollständig stabil.

Der Ablauf einer jeden Veröffentlichung ist also folgender:-nextN Testversion → Neueste Version (veröffentlicht, auf Probe) → Stabile Version (wird nach Bestätigung der Fehlerfreiheit freigegeben).

Changelog

Older releases: see CHANGELOG_OLD.md.

0.60.0 (2026-09-15)

• 🌟 New feature: Keyboard shortcuts on Mac, iPad and iPhone now accept Cmd (and Option for copy-drag) and hint the matching key symbols (#651)
• 🌟 New feature: Add widget - a search box filters the list as you type, and non-matching entries are hidden (#652)
• Add widget - picking a type no longer adds it right away, so its hint stays readable and another type can be chosen (#652)
• 🌟 New feature: Custom CSS - the tab bar carries .aura-tabs-top / .aura-tabs-bottom, so a rule can pad the footer bar only, and each tab carries .aura-tab / .aura-tab-active
• 🌟 New feature: AC control - Daikin air conditioners (daikin-cloud) can be picked as a manufacturer, filling every datapoint from one device (#650)
• 🌟 New feature: AC control - setpoint, fan speed and vanes follow the operation mode where a device keeps one datapoint per mode, and take their limits from it (#650)
• 🌟 New feature: AC control - vane positions are selectable, with a Powerful button and room humidity alongside them (#650)
• 🌟 New feature: Widgets can show a fullscreen button, so a chart or list fills the screen on a phone (#644)
• 🌟 New feature: Editor - a right-click opens the widget menu, where a single entry copies a widget's look and pastes it onto the next one: the full style within the same widget type, the card look (transparency, own CSS variables, title and icon) across types (#654)
• Editor - widget controls are locked while designing, so a click picks up the card instead of switching the real device; the toolbar padlock unlocks them (#655)
• 🌟 New feature: Tab bar - a footer bar marks the active tab with a line above the icon; the marker side is configurable (#657)
• Theme - the navigation can cast a shadow: Design -> Theme -> Navigation has its own shadow field (#640)
• Theme - switching light/dark in the header no longer keeps a colour from the other half, so the navigation background follows the design again (#640)
• Theme - Navigation and Header moved to the top of the colour list, and the icon fields show the colour they really inherit instead of the accent (#640)
• Theme - the Design page opens on the brightness that is on screen, so a colour set there is visible right away; pick "Shared" to set both (#640)
• Theme - the header's light/dark button no longer switches the automatic one off: the next system switch, or a second press, hands the brightness back to it (#640)

0.59.4 (2026-09-14)

• HTML widget - buttons and sliders in your own HTML can now write datapoints: aura.setState / toggle / getState / subscribe / sendTo, with ready-made examples in the editor (#649)

0.59.3 (2026-09-13)

• AI assistant - the shipped widget schema, recipes and theme tokens are back in step with the app, so the newest options (slider scale, list timestamps, select cells, tab badges, own themes) are visible to a connected AI again, and the slider scale is now part of the measured minimum heights it plans with
• Theme - own colours for the navigation icons (tab bar, section bar/menu, menu widget) plus a colour for inactive labels; the section navigation now follows the navigation colours instead of the accent (#640)
• Theme - the active chip colour is no longer overruled by the accent: the carousel honours it too and the tint behind an active chip is painted again (#640)
• Theme - the light/dark choice above and below the theme editor is one choice now, and saving an own theme captures the half you are editing instead of the one your admin browser happens to show (#640)

0.59.2 (2026-09-13)

• 🌟 New feature: Slider - optional scale showing the step values, min and max along the track; available in the Slider widget, list rows and the universal widget's slider cell (#643)
• iFrame and HTML widgets - on phones the frame keeps its dashboard aspect ratio instead of the full row height, so the embedded page no longer sits in a tall empty box (#645)
• 🌟 New feature: Static and dynamic list - a datapoint in the second line can show when it last changed (or was last written) instead of its value; relative by default, with time and date formats available, and an empty datapoint id means the row own datapoint (#646)

0.59.1 (2026-09-13)

• Auto-return pause element - choose icon only, label only or both, with or without background

0.59.0 (2026-09-13)

• 🌟 New feature: Markers - the aggregate count of a tab or section can now count only conditional markers or sum the numbers of count markers, and a single marker can be excluded from it
• 🌟 New feature: Settings - with "theme follows browser" the light and the dark theme can now be picked and fine-tuned separately: the preset grid stays usable and CSS variables have a shared, a light and a dark tab (#640)
• 🌟 New feature: Settings - own themes can be saved, renamed, duplicated, exported and imported, and are offered wherever a theme is picked - including as the light or dark half of the browser sync (#640)

0.58.3 (2026-09-13)

• Diagnostics - add ?diag=1 to the dashboard URL to get an on-device report (icons, which bundle is running, what is on the wire, which background tabs still stream) for bug reports (#636)
• Tab bar - hidden and disabled tabs no longer count towards the bar: a section left with a single visible tab shows no tab bar

0.58.2 (2026-09-12)

• Icons - icons that still have to be fetched on a cold device are now forced to repaint, so they no longer stay invisible on Android until you touch the screen (#636)
• Menu elements - a widget added to the header, tab bar or section menu now starts at the size it would have on a dashboard and is resized by dragging the corner of its preview, pixel by pixel; the width/height fields and the per-element layout picker are gone, a new element opens itself and the whole row toggles it (#634)

0.58.1 (2026-09-12)

• 🌟 New feature: Auto-return - new "Pause" element for the header, tab bar and section menu: one tap keeps the device on the page you are looking at, and the pause ends by itself (#638)
• 🌟 New feature: Auto-return - controllable per device through aura.0.clients.<id>.idleReturn.snoozeMinutes and .delay (and for all devices through aura.0.idleReturn.*) (#638)
• 🌟 New feature: Auto-return - can now be switched off per section and per tab; scrolling counts as activity and a fullscreen widget suspends it (#638)
• Icons - every icon a device has already shown is kept on that device, so a reload paints them right away and asks for nothing: icons no longer stay invisible on Android browsers until you touch the screen (#636)

0.58.0 (2026-09-11)

• 🌟 New feature: Lists, popups and messages - {{parent2}}, {{parent3}} ... address datapoints further up the tree, so a row can reach another channel of the same device (e.g. a HomeMatic maintenance channel); picking such a datapoint in the second-line template stores the pattern automatically (#637)

0.57.0 (2026-09-11)

• 🌟 New feature: evcc - the widget is now called "Energiefluss (evcc)" and works far beyond evcc: the data source is a dropdown of the energy instances actually installed (evcc, SMA, Fronius, E3/DC, Kostal, SENEC, sonnen, Victron, Shelly and more) or "manual", picking a non-evcc one searches what that instance publishes and fills in the datapoints, and production and house consumption can now come from datapoints of your own just like grid and battery could, so with all five set the widget draws any PV system without an evcc instance; power datapoints in kW are converted automatically from the datapoint's own unit, a prefix can still be typed by hand and no longer snaps the old value back while you type, and a freshly added widget matches the text and icon size of every other widget and follows the global font scale instead of towering over them (#629)
• Date/time fields - no more double picker icon: where a browser insists on drawing its own clock, Aura no longer puts a second one next to it (#633)
• 🌟 New feature: Header, tab bar and section menu - the single clock and single datapoint slot became a list: add as many clocks, datapoints and texts as you like, left next to the title or on the right, with existing settings carried over automatically; a menu element can also be any widget, either a reference to one that already sits on a dashboard or an instance of its own, you pick which of the widget's layouts the menu draws (a fresh one starts on the densest, so a switch no longer towers over a 32px bar), and its conditions, badges and click actions work there just as they do on the dashboard (#634)
• 🌟 New feature: Conditions - the AND/OR between two clauses can now be set per row instead of for the whole rule, and clauses can be bracketed; a preview line spells out what the rule reads as (#635)
• Icons - widget, tab and list icons are now delivered by Aura itself instead of the public Iconify servers, so they also show up in Samsung Internet, Opera, Fully Kiosk and other browsers that block those hosts, and on a tablet with no internet; the icon search in the editor takes the same route (#636)

0.56.4 (2026-09-09)

• General - verified on Node.js 26; the CI adapter tests now run on Node 22, 24 and 26 (#631)
• Knob - only the dial reacts to touch now: a swipe on the free area next to it scrolls the page instead of turning the knob, and the value no longer skews on widgets that are not square (#630)
• Settings - the admin PIN can be changed again: an expired admin session now says so and sends you to the login page instead of answering "Wrong PIN", and the password manager no longer prefills the new-PIN field (#632)
• Admin login - every refusal now names its reason instead of "Wrong PIN": too many attempts (with the wait), an admin PIN that is already set, or no reachable Aura instance behind the page - which used to offer a first-run setup that could never succeed (#632)

0.56.3 (2026-09-08)

• PIN protection - the "Editable via MCP" release now shows up as soon as a PIN is typed, instead of only after saving and reloading
• PIN protection - the PIN settings of a section or tab no longer vanish after saving
• PIN protection - sections and tabs got a "Remove PIN" button; a PIN kept server-side could not be taken back at all, because its input field is always empty. The adapter puts the protected content back into the configuration and forgets the vault entry in one step
• Section title - the MCP height check now treats the "framed" style as the card it is: it asks for the 3 rows the style needs to look right instead of the 2 it technically renders in, and follows the widget padding of the dashboard like every other card

0.56.2 (2026-09-08)

• MCP - a widget id that sits in a PIN-protected view is now refused with the release hint instead of "no widget with that id", and the structure note no longer lists aura_compact among the tools that work without a release
• Widget import - the datapoint is optional again: a widget that gets its values from a template or bindings can be imported without typing a dummy id (#625)

0.56.1 (2026-09-08)

• MCP - PIN-protected sections and tabs are now reported as protected instead of empty; without a release the AI server only sees their structure (id, type, gridPos) and cannot write, and aura_review counts them as not checked
• MCP - new per-view switch "Editable via MCP" in the editor (section/tab gear, admin login required) releases a PIN-protected view for the AI server without ever revealing the PIN; aura_write_tab stays blocked there
• PIN protection - a section's own badges and badge aggregate no longer get lost when a PIN is set on it

0.56.0 (2026-09-08)

• Section title - the "Framed" style is now part of the AI widget schema, so the MCP accepts what the editor writes
• Layout styles come from one list for the editor, the AI schema and the documentation - styles no widget ever rendered are gone, and the light, camera and knob now show their real styles everywhere
• Editor - a stored layout the widget type does not know is now named instead of silently falling back to the default
• AI review - aura_review now checks the stored dashboard against the widget schema and reports values a write would refuse
• 🌟 New feature: PIN protection - section and tab PINs are now enforced server-side: the PIN and the protected widgets stay in the adapter and only reach the browser after the code is verified (scrypt hash + rate limit against guessing), so the gate holds up even against the dev tools
• 🌟 New feature: Admin login - now verified server-side instead of in the browser; please set the admin password once after this update (the previous one does not carry over)

0.55.4 (2026-09-08)

• List - a switch row with switchStyle "slide" plus on/off labels now keeps the slide toggle and puts the label next to it, instead of silently replacing the toggle with a text pill
• AI access - broad round of improvements for the MCP tools that let an AI read and build dashboards: more widget types report an honest height (weather and status overview are measured now, content from an instance or free HTML is flagged as "check it in the browser"), options that void a measurement say so instead of reporting "fits", aura_rendered can measure a tab nobody has open by rendering it off-screen at the real grid width, a section with a single tab is warned that its last grid row disappears once a second tab is added, aura_tab keeps embedded images readable via trimming plus images/groupDefs switches (and write tools refuse a trimmed payload), aura_validate hands back a token the write tools accept instead of sending a tab through the conversation twice, and theme colors are reported in the only form a configuration accepts, var(--light-on, var(--accent-yellow))

0.55.3 (2026-09-07)

• Section title - new "framed" style that looks like a normal widget card, subtitle now shows in the compact and minimal styles too, the accent bar spans title and subtitle, and the title is no longer clipped at the top of the mobile view; the rule can now be hidden or given its own color, title and subtitle take their own color and text size, and the subtitle accepts the same value bindings as the HTML widget
• Settings - deleting a connected device now removes its whole datapoint tree instead of leaving parts of it behind, works from the aura.0.clients.deleteRequest datapoint regardless of the ack flag, and a renamed or speaking client id is no longer cut after 8 characters in the object tree (#624)
• Settings - the frontend notice about a new adapter version now waits for a confirmation instead of fading away after a few seconds, and comes back after a reload until it is answered; the new "Update notice has to be confirmed" option turns that off (#617)

0.55.2 (2026-09-07)

• Input field - optional unit next to the field, in the Eingabefeld widget, the static and dynamic list rows and the Universal Widget cell (#622)

0.55.1 (2026-09-07)

• 🌟 New feature: Popups - the inner padding is now adjustable (globally, per popup view, per click action), and the scrollbar lane is only reserved while the popup really scrolls, so list rows in a popup get the full width (#621)

License

MIT License

Copyright (c) 2026 hdering aura@dering-online.de

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.