Desktop App (Windows / macOS / Linux) for Home Assistant built with Electron
This project is fork from iprodanovbg/homeassistant-desktop and mrvnklm/homeassistant-desktop.
The status of the project with regards to its original maintainers is unknown - the original author (mrvnklm) has seemingly deleted their repository and the most well-developed fork by iprodanovbg has not had any meaningful updates since February 2023. Due to loss of functionality from aging dependencies I simply opted to fork the repository and make the necessary changes since I use the app every day. This fork can be maintained so long as there is a need or desire to, so pull requests to improve or fix functionality are most welcome here - this repository has merged the (at present 2) open PRs from the source and they are included in release 1.5.4.
I hope this updated fork can be of some use to others if you like/liked the app! Issues should now be open to submit if you have any, though please be aware I may not be able to resolve all issues quickly or comprehensively - though I will do my best.
Just download the latest version for your platform from the release section to install Home Assistant
- hover / click the tray icon to open the app
- supports multiple instances of Home Assistant (including automatic switching)
- automatic instance discovery using bonjour
- right-click context menu for settings / reset / quit the app
- global keyboard shortcut (defaults to Cmd/Ctrl + Alt + X but can be changed) can be enabled to show / hide Home Assistant
- fullscreen mode (Cmd/Ctrl + Alt + Return)
- automatic update checks (if not disabled in context menu)
- at present support for self-signed certificates is YMMV (I recommend using Let's Encrypt to resolve this, though it is something I'll try to work on)
- support for Linux distros may vary, app tested on Debian-based flavors (XORG) but detailed feedback is welcome
- support for Wayland is limited - the application will still run however a number of Electron's features aren't implemented yet (e.g. shortcuts, checkbox display)
- if using "detached window" on Windows, instead of dragging, you have to resize it to move it
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
Forked 2024, Dusty Armstrong
Copyright 2022, Ivan Prodanov
Copyright 2020-2021, Marvin Kelm
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.