Repository navigation
Home Assistant
With Mikonus, you can publish your home as an interactive 3D dashboard in Home Assistant.
You continue to create and edit your home in Mikonus. Home Assistant then displays the published scene as a dashboard card, including live device states and controls.
To allow Home Assistant to receive published Mikonus scenes, you need the Mikonus integration for Home Assistant.
The Mikonus integration is currently installed through its own HACS repository.
In Home Assistant, open:
HACS → Integrations
Then open the menu in the top-right corner and select:
Custom repositories
Add the Mikonus repository and select:
Integration
Repository:
https://github.com/mikonus-app/mikonus-home-assistant
Confirm by selecting Add.
After adding the repository, Mikonus Dashboard will appear in HACS.
Open the entry and install the latest version.
A restart of Home Assistant is required after installation.
After restarting, open:
Settings → Devices & services
Select Add integration and search for:
Mikonus Dashboard
Add the integration.
No additional credentials are required for the integration setup itself.
Home Assistant is now ready to receive published Mikonus scenes.
In Mikonus, open:
Smart Home → Connections → Home Assistant
Add your Home Assistant instance and establish the connection.
Depending on your setup, you will need the address of your Home Assistant installation and the required authentication.
Once connected, Home Assistant entities can be used in Mikonus.
Once Home Assistant is connected, you can link Home Assistant entities to the matching objects in your Mikonus project.
The easiest way is:
- Open the Home view in Mikonus.
- Press and hold the 3D object you want to use.
- Select the device assignment option.
- Select Home Assistant as the provider.
- Select the matching entity.
For example, you can link a lamp in Mikonus to a light entity in Home Assistant.
The assignment is published together with your dashboard scene.
Once your home and devices are ready, you can publish your scene directly to Home Assistant.
In Mikonus, open:
Smart Home → Dashboards → Home Assistant
Select Publish.
Mikonus transfers the dashboard scene and the required device assignments to Home Assistant.
After publishing, you can add the Mikonus card to a Home Assistant dashboard.
Open the dashboard you want to use and add a new card.
Select:
Mikonus 3D
You can then select the published scene.
If only one scene is available, it may be selected automatically.
Mikonus supports multiple published scenes in Home Assistant.
If more than one scene is available, you can choose which one should be displayed when configuring the Mikonus card.
This allows you to use separate scenes for different homes, areas or variants.
Assigned Home Assistant devices appear directly at their positions in the floor plan.
Depending on the device type, you can:
- turn lights on and off
- adjust brightness and light color
- control blinds and shutters
- control thermostats
- view sensor states
- control locks
- control robot vacuums
Tap a device to open the available information and controls.
The Mikonus card supports both a 3D view and a 2D floor-plan view.
Use the 2D / 3D switch directly in the card to switch between both views.
If your scene contains multiple floors, you can also switch between the available floors.
Depending on the version of the Mikonus card, you can configure different presentation options.
These can include:
- camera settings
- lighting and ambient brightness
- shadows
- floor switching
- markers and overlays
- additional presentation settings
These settings only affect how the scene is displayed in the dashboard. Your actual Mikonus project remains unchanged.
Your Mikonus project remains the central source for your home.
If you later make changes, for example:
- rooms or walls
- interior objects
- device assignments
- floors
- smart-home objects
simply publish the scene to Home Assistant again.
The existing dashboard card will then use the updated version.
Published Mikonus scenes can be managed in Home Assistant.
Depending on the current version of the integration, you can view, replace or remove published scenes.
Mikonus does not automatically change your local project when doing this.
If the integration, publishing process or card does not work, you can find more information here: