Sprache: Italiano · English · Français · Español · Deutsch

Referenz: Repository dckiller51/astrion-custom-dashboard, Branch main, Commit d73ec52 (App 1.1.4). Jede beschriebene Option wurde im Kotlin-Quellcode geprüft (config/DashboardLoader.kt, config/AppConfig.kt, cards/impl/*.kt). Spätere Versionen können abweichen.

Alle Beispiele verwenden fiktive Entitäten (light.soggiorno, media_player.salotto, …), identisch in allen Sprachversionen: ersetze sie durch deine eigenen.

1. Was es ist (und was nicht)
2. Speicherort und Hochladen
3. Wurzelstruktur
4. Seiten
5. Karten: allgemeine Regeln
6. Karten ohne Editor-Formular
7. Karten mit Editor-Formular
8. Physische Tasten (hotkeys / longHotkeys)
9. Harmony, lokales IR und Aktivitäten
10. Theme
11. Vollständiges Beispiel
12. Fehlerbehebung

Astrion Custom Dashboard ist eine Android-App, die den Launcher der Fernbedienung Sanytron Astrion HA100 ersetzt. Sie kommuniziert per WebSocket mit Home Assistant.

• Es ist kein Lovelace-Dashboard und wird nicht über HACS installiert.
• Die „Karten“ sind native App-Komponenten, keine Lovelace-Karten: die Syntax ist JSON, nicht YAML.
• Viele Optionsnamen ähneln den Mushroom-Karten, die App liest aber nur die hier aufgeführten Optionen.

Bearbeitungswege:

1. Online-Editor — https://dckiller51.github.io/astrion-custom-dashboard/: Formulare für Seiten, Karten und Tasten; erzeugtes JSON herunterladen.
2. Lokale Seite — http://<ip-der-fernbedienung>:8080 (Adresse im Einstellungsbereich sichtbar): dashboard.json hoch-/herunterladen, Icons hochladen. Das Hochladen lädt das Dashboard ohne Neustart neu.
3. adb — adb push dashboard.json /sdcard/astrion/dashboard.json, dann die App erneut öffnen.

⚠️ Ist das JSON ungültig, stürzt die App nicht ab: sie lädt ihr eingebautes Layout und zeigt dashboard.json invalid (…) — using built-in defaults. Lade vor jedem Hochladen eine Sicherung herunter.

⚠️ Wird im Online-Editor eine Karte erneut geöffnet und über das einfache Formular gespeichert, werden ihre Optionen komplett neu geschrieben: reine JSON-Felder (Abschnitt 6) gehen verloren. Für diese Karten immer das Feld „Options (raw JSON)“ verwenden.

Die Wurzel ist ein JSON-Objekt. Ein Array von Karten wird ebenfalls akzeptiert: es wird zu einer einzigen Seite namens Main.

{
  "startPage": 0,
  "pages": [
    { "name": "Home", "cards": [] }
  ],
  "hotkeys": [],
  "longHotkeys": []
}

ℹ️ Der Online-Editor kann auch openWhenState / closeWhenState schreiben, im analysierten Commit liest DashboardLoader.kt sie aber nicht: der Öffnungszustand ist immer on. Für eine Entität mit anderen Zuständen einen Template-binary_sensor in HA anlegen.

Beispiel — Türsprechstellen-Seite, die beim Klingeln öffnet und mit BACK schließt:

{
  "startPage": 0,
  "pages": [
    { "name": "Casa", "cards": [] },
    {
      "name": "Citofono",
      "parent": "Casa",
      "openWhenEntity": "binary_sensor.campanello",
      "cards": [
        { "type": "camera", "options": { "entity_id": "camera.ingresso" } }
      ]
    }
  ]
}

Jede Karte hat diese Form:

{ "type": "light", "options": { "entity_id": "light.soggiorno" } }

• type ist Pflicht; options ist optional.
• Ein nicht registrierter type ist kein Parse-Fehler: die Karte wird einfach nicht gezeichnet.
• "pin": "bottom" in options (jede Karte) heftet sie unten an die Seite, außerhalb des Scrollbereichs.
• PNG-Icons: absoluter Pfad, z. B. /sdcard/astrion/icons/netflix.png.
• Farben: #RRGGBB oder #AARRGGBB (Alpha zuerst). Ausnahme: switch.on_color akzeptiert nur #AARRGGBB (siehe 7.2).

Registrierte Typen (21) und Unterstützung im Online-Editor:

Im Online-Editor den Typ wählen (Gruppe Advanced (raw options)) und nur das options-Objekt in Options (raw JSON) einfügen. Die Beispiele zeigen die ganze Karte: kopiere den Inhalt von "options".

Eine Zeile pro Lautsprecher mit: Haken = Gruppenmitglied, ziehbarer Lautstärkebalken, Stumm, Lautst.−/+. Die erste Zeile ist der Master.

Verhalten:

• Anhaken → media_player.join auf dem Master mit group_members: [Lautsprecher], sofort.
• Haken entfernen → media_player.unjoin auf dem Lautsprecher.
• Der Zustand „in der Gruppe“ wird aus dem Attribut group_members des Lautsprechers gelesen (es muss den Master enthalten).
• Lautstärke: media_player.volume_set, volume_up, volume_down, volume_mute.

{
  "type": "speaker_group",
  "options": {
    "master": "media_player.salotto",
    "name": "Salotto",
    "speakers": [
      { "entity_id": "media_player.cucina", "name": "Cucina" },
      { "entity_id": "media_player.camera", "name": "Camera" },
      { "entity_id": "media_player.bagno", "name": "Bagno" }
    ]
  }
}

Nur-Lese-Liste: Name, aktueller Wert, unit_of_measurement. Kein Verlaufsdiagramm. unknown / unavailable werden als — angezeigt.

{
  "type": "monitor",
  "options": {
    "title": "Ambiente",
    "entities": [
      { "entity_id": "sensor.temperatura_soggiorno", "name": "Temperatura" },
      { "entity_id": "sensor.umidita_soggiorno", "name": "Umidità" },
      { "entity_id": "sensor.co2_soggiorno" },
      { "entity_id": "sensor.potenza_casa", "name": "Consumo" }
    ]
  }
}

Horizontaler Container: Kindkarten erhalten gleiche Breite. Jedes Kind ist eine vollständige Karte (type + options). Jede Karte ist erlaubt, auch eine weitere row.

{
  "type": "row",
  "options": {
    "cards": [
      { "type": "cover", "options": { "entity_id": "cover.tapparella_sx", "name": "Sinistra", "layout": "vertical" } },
      { "type": "cover", "options": { "entity_id": "cover.tapparella_dx", "name": "Destra", "layout": "vertical" } }
    ]
  }
}

💡 In einer row besser "layout": "vertical" verwenden (light/cover/select): der horizontale Platz ist knapp.

Hintergrundbild mit Icons, die in Prozent positioniert werden. Kann auch Ziele eines mmWave-Radars und den Saugroboter anzeigen.

Felder jedes Elements:

{
  "type": "picture_elements",
  "options": {
    "image": "/sdcard/astrion/planimetria.png",
    "aspect": 1.5,
    "elements": [
      { "entity_id": "light.soggiorno", "left": 25, "top": 35 },
      { "entity_id": "light.cucina", "left": 70, "top": 30 },
      { "entity_id": "switch.lampada_studio", "left": 80, "top": 75 },
      { "service": "light.turn_off", "targets": ["light.soggiorno", "light.cucina"], "icon": "power", "left": 95, "top": 6 }
    ]
  }
}

💡 Koordinaten finden: Bild in einem Grafikprogramm öffnen, X/Y in Pixeln ablesen und left = X / Breite × 100, top = Y / Höhe × 100 berechnen.

Zeichnet bis zu targets nummerierte Punkte. Liest die Entitäten <prefix>_<n>_x und <prefix>_<n>_y mit n = 1…targets. Fehlt die Entität oder ist sie nicht numerisch, erscheint der Punkt nicht.

Angewandte Formel (zum Verständnis der Kalibrierung): left = origin_left + x_gedreht × x_skala, top = origin_top + y_gedreht × scale_y. Ergebnis auf 0–100 % begrenzt.

{
  "type": "picture_elements",
  "options": {
    "image": "/sdcard/astrion/planimetria.png",
    "elements": [],
    "radar": {
      "prefix": "sensor.radar_soggiorno_target",
      "targets": 3,
      "origin_left": 50,
      "origin_top": 5,
      "scale_x": 10,
      "scale_y": 10,
      "rotation": 0,
      "flip_x": false,
      "flip_y": false,
      "blend": "overlay"
    }
  }
}

💡 Kalibrierung: an einen bekannten Punkt stellen, beobachten, wo der Punkt erscheint, zuerst origin_*, dann scale_*, zuletzt rotation/flip_* korrigieren. Die Einheit von scale_* hängt davon ab, wie deine Firmware x/y liefert (mm, cm oder m).

Roboter-Icon pro Raum positioniert (HA liefert keine X/Y des Roboters, nur den aktuellen Raum). Tippen → Popup mit allen Steuerungen der vacuum-Karte (7.12). Akzeptiert dieselben Optionen wie vacuum und zusätzlich:

{
  "type": "picture_elements",
  "options": {
    "image": "/sdcard/astrion/planimetria.png",
    "elements": [],
    "vacuum": {
      "entity_id": "vacuum.robot",
      "name": "Robot",
      "map_image": "image.robot_mappa",
      "rooms": [
        { "name": "Cucina", "id": 16 },
        { "name": "Soggiorno", "id": 17 }
      ],
      "room_entity": "sensor.robot_stanza_corrente",
      "room_positions": { "Cucina": [70, 30], "Soggiorno": [25, 40] },
      "dock_position": [5, 60]
    }
  }
}

Die Karte title hat ein Formular, antippbare Titel und Untertitel lassen sich aber nur per JSON einrichten. Gleiches Aktionsvokabular wie scene_grid (7.10), mit Präfix title_ oder subtitle_:

Beispiel — Untertitel „Alle anzeigen →“, der die Seite Licht öffnet:

{
  "type": "title",
  "options": {
    "title": "Soggiorno",
    "subtitle": "Vedi tutte le luci →",
    "subtitle_page": "Luci",
    "icon": "/sdcard/astrion/icons/sofa.png",
    "divider": true,
    "color": "#7FB3C4"
  }
}

Auch diese lassen sich von Hand schreiben. Alle vom Code gelesenen Optionen sind aufgeführt.

{ "type": "switch", "options": { "entity_id": "switch.stufa", "name": "Stufa", "icon": "heater", "on_color": "#B3902828" } }

Tippen = Toggle; langer Druck = Detail-Popup.

Ist keines der drei show_*_control vorhanden, erscheint nur der Helligkeitsregler. Sobald eines gesetzt ist, erscheinen nur die auf true gesetzten. Bei mehreren Reglern wechselt ein Pfeil-Button zwischen ihnen.

{ "type": "light", "options": { "entity_id": "light.soggiorno", "name": "Soggiorno", "layout": "horizontal", "use_light_color": true, "show_brightness_control": true, "show_color_control": true } }

Langer Druck = Popup mit Voreinstellungen 25/50/75 %.

Gleiche Logik wie bei light: ohne Flag erscheinen die Tasten. Regler erscheinen nur, wenn die Entität das passende Attribut liefert.

{ "type": "climate", "options": { "entity_id": "climate.soggiorno", "name": "Clima", "step": 0.5, "hvac_modes": ["heat", "cool", "auto"], "fan_mode_style": "icons" } }

• select: für input_select.* / select.*. Optionen: entity_id, name, icon_color, layout.
• source_select: Quelle eines media_player (source_list). Optionen: entity_id, name.

Kompakt: Tippen = Wiedergabe/Pause; langer Druck = Details.

Von der Entität nicht unterstützte Tasten (supported_features) werden ausgeblendet.

{
  "type": "button_grid",
  "options": {
    "columns": 2,
    "buttons": [
      { "name": "Netflix", "icon": "/sdcard/astrion/icons/netflix.png", "service": "media_player.play_media", "entity_id": "media_player.tv", "data": { "media_content_type": "app", "media_content_id": "com.netflix.ninja" } },
      { "name": "Buonanotte", "service": "script.buonanotte" }
    ]
  }
}

Felder jeder Kachel: name, icon, color und eine Aktion: entity_id (Szene/Skript), page, activityId (+hub), harmonyDevice+harmonyCommand (+hub), irDevice+irCommand, activity. Optional track + room (+devices), um sie als Aktivität zu verfolgen. Mit activity wird page ignoriert (Seite an der Aktivität festlegen).

Tippen = Vollbild mit Zoom (Pinch 1×–8×).

Optionen: entity_id (weather.*), time_format (12 Standard oder 24), forecast_rows (Standard 4), calendar_entity.

Befehle gehen direkt an den Harmony-Hub. Optionen: deviceId (Harmony-Geräte-Id), hub (optional).

Optionen: host, token, media_entity, play_entity, play_content_type (video/url), source (Standard Plex), show_on_deck, show_recently_added_movies, show_recently_added_shows (Standard true), items_per_row (Standard 12).

⚠️ Das Plex-Token steht im Klartext in der Datei: dashboard.json nicht weitergeben.

Verfügbare key-Namen der HA100: UP DOWN LEFT RIGHT CENTER, PAGE_UP PAGE_DOWN, VOLUME_UP VOLUME_DOWN MUTE, BACK HOME POWER VOICE, LIGHT CURTAIN SCENE AC, CUSTOM_1…CUSTOM_4.

Felder (Achtung: hier heißt die Entität entityId, in camelCase):

Eine Aktion pro Taste verwenden. Priorität: openOverlay → openCurrentActivityRoom → page → … → service.

{ "key": "CUSTOM_1", "service": "media_player.play_media", "entityId": "media_player.tv", "data": { "media_content_type": "app", "media_content_id": "com.netflix.ninja" } }

💡 Pfeiltasten und Lautstärke wiederholen sich beim Gedrückthalten: keine longHotkeys zuweisen.

irDevices — IR-Geräte, die über den eigenen IR-Sender der Fernbedienung gesteuert werden:

{
  "startPage": 0,
  "pages": [ { "name": "TV", "cards": [] } ],
  "irDevices": [
    {
      "id": "tv_salotto",
      "name": "TV Salotto",
      "commands": {
        "power": { "freq": 38000, "pattern": [9000, 4500, 560, 560] }
      }
    }
  ]
}

Statt commands: category + brand + model (Datenbank in /sdcard/astrion/ir-database/). Feld target: "local" (Standard) oder { "extender": "<id>" }.

activities — Szenarien mit mehreren Geräten:

Die Harmony-Konfiguration (Hub-IP/-Id) erfolgt auf der Seite :8080, nicht im JSON.

Alle optional (Standardwerte in Klammern): background (#0E2229), cardSurface (#1B343D), insetSurface (#152B33), controlBackground (#2C4C58), primaryText (#E6F0F1), mutedText (#93AFB6), iconTint (#CBDCE0), accent (#6EA8FE), accentSecondary (#4C6EF5), amber (#FFC24B), danger (#E06767), success (#4CAF50).

Fünf Seiten: Luci (Licht), Casa (Grundriss + Sensoren), Musica (Lautsprechergruppe), Clima (Klima), Citofono (Türsprechstelle mit automatischem Öffnen).

{
  "startPage": 1,
  "theme": { "background": "#0E2229", "accent": "#6EA8FE" },
  "pages": [
    {
      "name": "Luci",
      "cards": [
        { "type": "title", "options": { "title": "Luci", "subtitle": "Soggiorno e cucina", "divider": true, "subtitle_page": "Casa" } },
        { "type": "light", "options": { "entity_id": "light.soggiorno", "name": "Soggiorno", "show_brightness_control": true, "show_color_temp_control": true } },
        { "type": "row", "options": { "cards": [
          { "type": "switch", "options": { "entity_id": "switch.stufa", "name": "Stufa", "icon": "heater", "on_color": "#B3902828" } },
          { "type": "switch", "options": { "entity_id": "switch.ventilatore", "name": "Ventilatore", "icon": "fan" } }
        ] } },
        { "type": "scene_grid", "options": { "layout": "row", "pin": "bottom", "scenes": [
          { "entity_id": "scene.cena", "name": "Cena", "color": "#66FFB300" },
          { "entity_id": "script.tutto_spento", "name": "Spegni", "color": "#66000000" }
        ] } }
      ]
    },
    {
      "name": "Casa",
      "cards": [
        { "type": "clock_weather", "options": { "entity_id": "weather.casa", "time_format": 24, "forecast_rows": 3 } },
        { "type": "picture_elements", "options": {
          "image": "/sdcard/astrion/planimetria.png",
          "aspect": 1.3,
          "elements": [
            { "entity_id": "light.soggiorno", "left": 30, "top": 40 },
            { "entity_id": "light.cucina", "left": 70, "top": 55 },
            { "service": "light.turn_off", "targets": ["light.soggiorno", "light.cucina"], "icon": "power", "left": 92, "top": 8 }
          ]
        } },
        { "type": "monitor", "options": { "title": "Sensori", "entities": [
          { "entity_id": "sensor.temperatura_soggiorno", "name": "Soggiorno" },
          { "entity_id": "sensor.umidita_soggiorno", "name": "Umidità" },
          { "entity_id": "sensor.potenza_casa", "name": "Consumo" }
        ] } }
      ]
    },
    {
      "name": "Musica",
      "cards": [
        { "type": "media_player", "options": { "entity_id": "media_player.salotto", "variant": "full", "media_controls": "shuffle,previous,play_pause,next,repeat", "volume_controls": "mute,set" } },
        { "type": "speaker_group", "options": { "master": "media_player.salotto", "name": "Salotto", "speakers": [
          { "entity_id": "media_player.cucina", "name": "Cucina" },
          { "entity_id": "media_player.camera", "name": "Camera" }
        ] } },
        { "type": "source_select", "options": { "entity_id": "media_player.salotto", "name": "Sorgente" } }
      ]
    },
    {
      "name": "Clima",
      "cards": [
        { "type": "climate", "options": { "entity_id": "climate.soggiorno", "name": "Clima", "step": 0.5 } },
        { "type": "cover", "options": { "entity_id": "cover.tapparella_soggiorno", "name": "Tapparella", "show_buttons_control": true, "show_position_control": true } }
      ]
    },
    {
      "name": "Citofono",
      "parent": "Casa",
      "openWhenEntity": "binary_sensor.campanello",
      "cards": [
        { "type": "camera", "options": { "entity_id": "camera.ingresso", "mode": "stream", "fit": "cover" } }
      ]
    }
  ],
  "hotkeys": [
    { "key": "LIGHT", "page": "Luci" },
    { "key": "CURTAIN", "page": "Casa" },
    { "key": "SCENE", "page": "Musica" },
    { "key": "AC", "page": "Clima" },
    { "key": "VOLUME_UP", "service": "media_player.volume_up", "entityId": "media_player.salotto" },
    { "key": "VOLUME_DOWN", "service": "media_player.volume_down", "entityId": "media_player.salotto" },
    { "key": "VOICE", "openOverlay": "settings" }
  ],
  "longHotkeys": [
    { "key": "LIGHT", "service": "script.turn_on", "entityId": "script.tutto_spento" }
  ]
}