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

Référence : dépôt dckiller51/astrion-custom-dashboard, branche main, commit d73ec52 (app 1.1.4). Chaque option décrite a été vérifiée dans le code Kotlin (config/DashboardLoader.kt, config/AppConfig.kt, cards/impl/*.kt). Les versions ultérieures peuvent changer.

Tous les exemples utilisent des entités fictives (light.soggiorno, media_player.salotto, …), identiques dans toutes les langues : remplacez-les par les vôtres.

1. Ce que c'est (et ce que ce n'est pas)
2. Emplacement du fichier et envoi
3. Structure racine
4. Pages
5. Cartes : règles communes
6. Cartes sans formulaire dans l'éditeur
7. Cartes avec formulaire
8. Touches physiques (hotkeys / longHotkeys)
9. Harmony, IR local et Activités
10. Thème
11. Exemple complet
12. Dépannage

Astrion Custom Dashboard est une application Android qui remplace le lanceur de la télécommande Sanytron Astrion HA100. Elle communique avec Home Assistant via WebSocket.

• Ce n'est pas un tableau de bord Lovelace et elle ne s'installe pas via HACS.
• Les « cartes » sont des composants natifs de l'app, pas des cartes Lovelace : la syntaxe est du JSON, pas du YAML.
• Beaucoup de noms d'options imitent les cartes Mushroom, mais seules les options listées ici sont lues par l'app.

Méthodes de modification :

1. Éditeur en ligne — https://dckiller51.github.io/astrion-custom-dashboard/ : formulaires pour pages, cartes et touches ; téléchargez le JSON généré.
2. Page locale — http://<ip-télécommande>:8080 (adresse affichée dans le panneau Paramètres) : envoi/téléchargement de dashboard.json, envoi d'icônes. L'envoi recharge le tableau de bord sans redémarrage.
3. adb — adb push dashboard.json /sdcard/astrion/dashboard.json, puis rouvrez l'app.

⚠️ Si le JSON est invalide, l'app ne plante pas : elle charge sa disposition intégrée et affiche dashboard.json invalid (…) — using built-in defaults. Téléchargez toujours une sauvegarde avant l'envoi.

⚠️ Dans l'éditeur en ligne, rouvrir une carte et l'enregistrer via le formulaire simple réécrit ses options de zéro : les champs JSON uniquement (section 6) sont perdus. Pour ces cartes, utilisez toujours le champ « Options (raw JSON) ».

La racine est un objet JSON. Un tableau de cartes est aussi accepté : il devient une page unique nommée Main.

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

ℹ️ L'éditeur en ligne peut aussi écrire openWhenState / closeWhenState, mais dans le commit analysé DashboardLoader.kt ne les lit pas : l'état d'ouverture est toujours on. Pour une entité avec d'autres états, créez un binary_sensor template dans HA.

Exemple — page interphone qui s'ouvre à la sonnette et se ferme avec BACK :

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

Chaque carte a cette forme :

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

• type est obligatoire ; options est facultatif.
• Un type non enregistré ne provoque pas d'erreur d'analyse : la carte n'est simplement pas dessinée.
• "pin": "bottom" dans options (toute carte) l'épingle en bas de la page, hors défilement.
• Icônes PNG : chemin absolu, ex. /sdcard/astrion/icons/netflix.png.
• Couleurs : #RRGGBB ou #AARRGGBB (alpha en premier). Exception : switch.on_color n'accepte que #AARRGGBB (voir 7.2).

Types enregistrés (21) et prise en charge par l'éditeur :

Dans l'éditeur en ligne, choisissez le type (groupe Advanced (raw options)) et collez uniquement l'objet options dans Options (raw JSON). Les exemples ci-dessous montrent la carte entière : copiez ce qui se trouve dans "options".

Une ligne par enceinte : coche = membre du groupe, barre de volume déplaçable, sourdine, vol−/vol+. La première ligne est le maître.

Comportement :

• Cocher → media_player.join sur le maître avec group_members: [enceinte], immédiatement.
• Décocher → media_player.unjoin sur l'enceinte.
• L'état « dans le groupe » est lu dans l'attribut group_members de l'enceinte (il doit contenir le maître).
• Volume : 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" }
    ]
  }
}

Liste en lecture seule : nom, valeur actuelle, unit_of_measurement. Pas d'historique. unknown / unavailable s'affichent —.

{
  "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" }
    ]
  }
}

Conteneur horizontal : les cartes enfants ont une largeur égale. Chaque enfant est une carte complète (type + options). Toute carte est permise, y compris une autre 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" } }
    ]
  }
}

💡 Dans une row, préférez "layout": "vertical" (light/cover/select) : l'espace horizontal est réduit.

Image de fond avec des icônes placées en pourcentage. Peut aussi afficher les cibles d'un radar mmWave et le robot aspirateur.

Champs de chaque élément :

{
  "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 }
    ]
  }
}

💡 Trouver les coordonnées : ouvrez l'image dans un éditeur, relevez X/Y en pixels et calculez left = X / largeur × 100, top = Y / hauteur × 100.

Dessine jusqu'à targets points numérotés. Lit les entités <prefix>_<n>_x et <prefix>_<n>_y avec n = 1…targets. Si l'entité manque ou n'est pas numérique, le point n'apparaît pas.

Formule appliquée (pour comprendre l'étalonnage) : left = origin_left + x_pivoté × échelle_x, top = origin_top + y_pivoté × scale_y. Résultat borné à 0–100 %.

{
  "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"
    }
  }
}

💡 Étalonnage : placez-vous à un point connu, regardez où apparaît le point, corrigez d'abord origin_*, puis scale_*, enfin rotation/flip_*. L'unité de scale_* dépend de la façon dont votre firmware expose x/y (mm, cm ou m).

Icône du robot placée par pièce (HA n'expose pas X/Y du robot, seulement la pièce actuelle). Appui → popup avec toutes les commandes de la carte vacuum (7.12). Accepte les mêmes options que vacuum, plus :

{
  "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]
    }
  }
}

La carte title a un formulaire, mais le titre et le sous-titre cliquables ne se configurent qu'en JSON. Même vocabulaire d'actions que scene_grid (7.10), préfixé par title_ ou subtitle_ :

Exemple — sous-titre « Tout voir → » qui ouvre la page Lumières :

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

Elles peuvent aussi s'écrire à la main. Toutes les options lues par le code sont listées.

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

Appui = toggle ; appui long = popup de détail.

Si aucun des trois show_*_control n'est présent, seul le curseur de luminosité s'affiche. Dès que vous en définissez un, seuls ceux à true s'affichent. Avec plusieurs commandes, un bouton flèche les fait défiler.

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

Appui long = popup avec préréglages 25/50/75 %.

Même logique que light : sans aucun indicateur, les boutons s'affichent. Les curseurs n'apparaissent que si l'entité expose l'attribut correspondant.

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

• select : pour input_select.* / select.*. Options : entity_id, name, icon_color, layout.
• source_select : source d'un media_player (source_list). Options : entity_id, name.

Compact : appui = lecture/pause ; appui long = détails.

Les boutons non pris en charge par l'entité (supported_features) sont masqués.

{
  "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" }
    ]
  }
}

Champs de chaque tuile : name, icon, color et une action : entity_id (scène/script), page, activityId (+hub), harmonyDevice+harmonyCommand (+hub), irDevice+irCommand, activity. Facultatifs : track + room (+devices) pour la suivre comme Activité. Avec activity, le champ page est ignoré (définissez la page sur l'Activité).

Appui = plein écran avec zoom (pincement 1×–8×).

Options : entity_id (weather.*), time_format (12 par défaut ou 24), forecast_rows (défaut 4), calendar_entity.

Commandes envoyées directement au hub Harmony. Options : deviceId (id appareil Harmony), hub (facultatif).

Options : host, token, media_entity, play_entity, play_content_type (video/url), source (défaut Plex), show_on_deck, show_recently_added_movies, show_recently_added_shows (défaut true), items_per_row (défaut 12).

⚠️ Le jeton Plex est en clair dans le fichier : ne partagez pas dashboard.json.

Noms key disponibles sur la 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.

Champs (attention : ici l'entité s'appelle entityId, en camelCase) :

Utilisez une action par touche. Priorité : 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" } }

💡 Les flèches et le volume se répètent en maintenant l'appui : ne leur attribuez pas de longHotkeys.

irDevices — appareils IR pilotés par l'émetteur de la télécommande :

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

À la place de commands : category + brand + model (base dans /sdcard/astrion/ir-database/). Champ target : "local" (défaut) ou { "extender": "<id>" }.

activities — scénarios multi-appareils :

La configuration Harmony (IP/ID du hub) se fait sur la page :8080, pas dans le JSON.

Toutes facultatives (défauts entre parenthèses) : background (#0E2229), cardSurface (#1B343D), insetSurface (#152B33), controlBackground (#2C4C58), primaryText (#E6F0F1), mutedText (#93AFB6), iconTint (#CBDCE0), accent (#6EA8FE), accentSecondary (#4C6EF5), amber (#FFC24B), danger (#E06767), success (#4CAF50).

Cinq pages : Luci (lumières), Casa (plan + capteurs), Musica (groupe d'enceintes), Clima (climatisation), Citofono (interphone à ouverture automatique).

{
  "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" }
  ]
}