Astrion Config Manager - dckiller51/astrion-custom-dashboard GitHub Wiki

Astrion Config Manager is a Home Assistant app (add-on) by @dvbit for managing the dashboards of one or more Astrion remotes from Home Assistant: a form editor, full version history, checks against your Home Assistant entities before sending, copying pages between remotes, and a live simulator.

๐Ÿค Community project. Developed and maintained by @dvbit, not by Astrion. Questions and bugs about it go to its GitHub repository.

Is it for me?

The remote's own web page and builder are enough for a single remote. The add-on is useful when:

  • you have several remotes (living room, bedroom, officeโ€ฆ) and want to manage them all from one place;
  • you want to check every entity exists in Home Assistant before sending a dashboard to a remote;
  • you want to copy a page from one remote to another;
  • you want your dashboards' history inside Home Assistant backups;
  • you want to try a dashboard on a simulator before sending it.
Builder on the remote Astrion Config Manager
Where Browser, on the remote's web page Home Assistant sidebar (Astrion)
Remotes One at a time All of them, in one list
Forms for every card โœ… โœ…
Undo / redo โœ… (1.3.0) โœ…
Version history โœ… on the remote, last 30 + pinned (1.3.0) โœ… every version, named milestones, in HA backups
Checks entities exist in HA before sending โ€” โœ… sending is blocked on errors
Copy a page to another remote โ€” โœ… with its icons, IR devices and links
Detects changes made on the remote itself โ€” โœ… "Changed on device"
Simulator Static preview โœ… live states, and taps really run (HA, Harmony Hub, IR)
Shared icon library โ€” โœ… missing icons uploaded on send
Needs Nothing Home Assistant OS or Supervised (apps/add-ons)

Both work together: you can use the builder for a quick change and the add-on for the rest.

Installation

  1. Settings โ€บ Apps (Add-ons) โ€บ App store โ€บ โ‹ฎ โ€บ Repositories, add:
    https://github.com/dvbit/ha-astrion-config-manager
    
  2. Install Astrion Config Manager, start it, then open Astrion in the sidebar (administrators only).
  3. On each remote, check that Web page is on (Settings โ€บ Web configuration, port 8080).
  4. In the add-on, + Add remote: name, IP, port 8080, screen size 480 ร— 800, portrait. The current dashboard of the remote becomes version 1.

Getting along with the remote

  • Every send from the add-on is also kept on the remote (Astrion 1.3.0+): it appears in the builder's ๐Ÿ•˜ Version history, so it can be restored from either side.
  • A change made on the remote (its builder, its web page, its Settings) is reported by the add-on as Changed on device. You choose: import it as a new version, overwrite it, or ignore it. Nothing is applied on its own.
  • New Astrion versions: the add-on follows each Astrion release and beta. Options it doesn't know yet are kept as they are, never removed. Check its changelog for the Astrion version it supports.

โš ๏ธ The simulator runs things for real

Tapping a light tile in the simulator turns the light on; an Activity tile starts the Activity (TV, amplifier, inputs). To just click through the pages, turn on Navigation only: the actions are listed instead of being run.

See also