V2.0.0 - Dwains Dashboard now 1 click install and complete refactored!
v2.0.0 is only compatible with HA 0.117 and newer
Note: Dwains Theme has been renamed to Dwains Dashboard!
How to install 2.0 fresh (if you are new):
https://dwainscheeren.github.io/dwains-lovelace-dashboard/getting-started/installation.html
How to update to 2.0:
You can only update to 2.0 if you have 1.4 installed.
The update process is a little bit complicated but I tried to make it as easy as possible. I made splitted the upgrade guide into 5 sections. If you experience any issues during the installation of 2.0 you can get live personal assistant from me, Dwains Dashboard Discord Server
Hint: With /config/ I mean the folder where your whole HA config is.
Section 1 - Remove existing Dwains Theme 1.*
To update to Dwains Dashboard 2.0.0 you first need to remove your 1. version of Dwains Theme follow all steps below (Don't worry we will keep your existing Dwains Theme config and addons, these will automatic work in 2.0.0), after that we need to modify your config files and your addons.*
- Make a backup of your current HA setup.
- Go to your /config/ folder and rename the folder dwains-theme to dwains-dashboard.
- Go to your /config/ folder and remove the file dwains-theme-lovelace-yaml.
- If you use any custom resources then backup the file /config/dwains-dashboard/resources/custom_resources.yaml somewhere safe. You need to add these back after installing 2.0.
- Go inside the folder /config/dwains-dashboard and remove the following folders: plugins, resources, translations, views. Make sure you keep the folders 'configs' and the folder 'addons'!.
- Go to the folder /config/themes and remove the files dwains-theme-black.yaml, dwains-theme-dark.yaml, dwains-theme-light.yaml and dwains-theme-white.yaml.
- Go to the folder /config/www and remove the folder dwains-theme.
- Go to the folder /config/packages and remove the folder dwains-theme.
- Go to the folder /config/custom_components and remove the folder dwains-theme.
Section 2- Some small changes to your existing Dwains Theme config files
The files scenes.yaml
and cameras.yaml
in your dwains dashboard configs needs to be changed. If you use them go to /config/dwains-dashboard/configs and open them.
- The file
cameras.yaml
needs to be changed like explained in this screenshot. - The file
scenes.yaml
needs to be changed like explained in this screenshot.
Section 3 - Adjust your addons
If you have any addons installed follow this step, otherwise skip this step!
Open up the folder /config/dwains-dashboard/configs and check, we need to make some adjustments to these files.
- If you use addons the name of the folder dwains-theme has changed to dwains-dashboard so for check all your config files. For example rename
path: 'dwains-theme/addons/rooms/hello-room/page.yaml'
topath: 'dwains-dashboard/addons/rooms/hello-room/page.yaml'
- Some addons use an include to heading.yaml, this file is deprecated.
Change the code as explained in this screenshot. - The following variables have been renamed, so if you use them, please rename them.
_d_t_config
to_dd_config
,_d_t_trans
to_dd_trans
,_d_t_icons
to_dd_icons
and_d_t_global
to_dd_global
In 2.0 there isn't a custom_resources.yaml
file anymore for any custom/third party cards. You will need to add them back by hand after installing 2.0. Go to HA Configuration -> Lovelace Dashboards and click in the top on Resources. Here you can click on the "+" sign bottom right and add all your custom cards you first had in dwains-theme/resources/custom_resources.yaml
.
Section 4 - Dynamic_page.yaml is deprecated
If you use the dynamic_page.yaml
in your current installation I have some good and bad news. The bad news is that it is deprecated, the good news is I created a new function for this to put as many custom pages in the main navigation bar as you want!!
You must copy the addon:
part you had in dwains-theme/configs/dynamic_page.yaml
into the addon:
part in dwains-dashboard/configs/more_page.yaml
. Then add the key main_menu: 'true'
to the addon. Then this addon will show up in your main navigation bar!
(Read more here)
Section 5 - Reboot HA
Reboot your Home Assistant. Dwains Theme 1.* should now be fully removed. Now we can install 2.0 with your existing config.
Section 6 - Install Dwains Dashboard 2.0
Install Dwains Dashboard 2.0 as explained here.
Breaking changes:
- Dynamic_page.yaml is deprecated! You need to copy your addon to an more_page addon. Now you can add
main_menu: true
to an more_page addon to show it in the main navigation bar! Read more here - Partial heading.yaml is deprecated! Replace it with a new card called
dwains-heading-card
see this screenshot. cameras.yaml
andscenes.yaml
have new structure! Please change these files to the new standard. The filecameras.yaml
needs to be changed like explained in this screenshot.The filescenes.yaml
needs to be changed like explained in this screenshot.- The following variables have been renamed, so if you use them, please rename them.
_d_t_config
to_dd_config
,_d_t_trans
to_dd_trans
,_d_t_icons
to_dd_icons
and_d_t_global
to_dd_global
- If you use addons the name of the folder dwains-theme has changed to dwains-dashboard so for check all your config files. For example rename
path: 'dwains-theme/addons/rooms/hello-room/page.yaml'
topath: 'dwains-dashboard/addons/rooms/hello-room/page.yaml'
New Features:
- Dwains Themes are now only applied to the Dwains Dashboard itself, this means that the colors are only used in the dashboard and not outside of it. You now can also use the default HA theme if you want to create a complete own theme. And you can also now set a own primary color (to replace the blue color) for icons etc. These settings can be found under Options in the integration Dwains Dashboard on your integrations page.
- You can set a own name for the dashboard in the integration options.
- You can set a own sidebar icon for the dashboard in the integration options.
- You can hide the cameras and scenes page from the main navigation bar
- You can add own pages to the main navigation bar, see more_page addons and the
main_menu: 'true'
part. - Vibration Sensor support for rooms @roblandry link
- Add weather page and link to it from weather widget. @roblandry link
- New Safety Devices @roblandry link
You now can add specific devices to a room like for example a smoke sensor. When this sensor gets triggered you get a warning inside your main header and in the room card. Seesafety:
in the room docs. - Add Tracking to Map @roblandry link
- Correct batteries with string values. Add color gradient to batteries. @roblandry link
- You can set if you want to see open, closer or partly_closed covers in the header (as state). Use
show_covers: closed
inglobal.yaml
(defaults to open).
Changes:
- Changed the name Dwains Theme to Dwains Dashboard.
- Completly refactored all the code of Dwains Dashboard.
- Use webpack now to compile my own Dwains Lovelace cards, no external load of Litelement through unkpg.com. This means you can use Dwains Dashboard now fully offline from the internet without problems. It's also a lot faster as the custom cards for my dashboard are now compiled and optimized.
- You don't have to change/touch any of your existing HA files/config to setup and use Dwain Dashboard. Setting up Dwains Dashboard is now all done automatic during installation.
- The
picture_path
key in persons.yaml for the photo of the person is now DEPRECATED! I now load the default picture automatic which you can set yourself in HA if you go to persons. - You now can use Dwains Dashboard together with HKI (Homekit Infused)
2.0.0 was a lot of work! Please consider a donation 👍