Kiosk-mode: Hides the Home Assistant header and/or sidebar (and more)

I’ve noticed that there is not any post about Kiosk-mode. The purpose of this post is to bring support about this custom plugin as well as sharing code snippets and ideas.

If you don’t know what Kiosk-mode is, it is a custom HACS plugin that allows one to hide the header, the sidebar and other elements of Home Assistant with the intention of sharing a dashboard with family or friends without the risk of them clicking on some admin entry-points or entering in some areas that are not intended for them.

Things that are out of the scope of Kiosk-mode:

  • It is intended only for lovelace dashboards. Kiosk-mode will only work in lovelace dashboards and that is why each lovelace dashboard needs its own configuration. Kiosk-mode is not intended for other dashboards (like Maps, Energy or History) and it will never be.
  • It is not intended for cards. Kiosk-mode is intended for general UI elements that will be in the same place in every lovelace dashboard independently of the system (for example, the header or the sidebar). It is not intended for things that are contained inside the dashboard.
  • It is not an RBAC solution. Kiosk-mode is a JavaScript plugin that is executed in the browser, which means that anybody with the minimum knowledge can deactivate it and bypass it. Do not take this plugin as a security measure because it is not and it will never be. If you want to make Home Assistant more secure, or seeing RBAC features implemented, you can vote for this feature.
  • It is not a styling solution. Kiosk-mode is not intended to hide something to make the interface nicer, to hide something to save space on the screen, or to change the styles of elements, use card-mod or a car-mod theme for that.

Hi, you might have a look at 🔹 Browser_mod - turn your browser into a controllable device, and a media_player

It can do that too and some more…

I know, and @dcapslock has been contributed to many more features lately :slightly_smiling_face:.

But kiosk-mode and browser-mod have lived together for a long time each one with its own scope and purposes. This thread is just to avoid users posting in other threads to ask questions or report issues about the plugin. Something that has increased since yesterday because a major breaking change has been released.

1 Like