This is the first post I’ve made to the Homey Community, and I’m glad to use it to present this project.
Getting started
You can install the Homey companion app from the App Store here: Dashboards App for Homey | Homey
HP23 users can access the locally installed dashboard by navigating to the app configuration page.
HP16/HP19 users must use the online version hosted at GitHub: homeyboard.github.io, as only the HP23 has the API-key feature.
Security
This app has no backend! Only the front end web application you use to create and view dashboards. That means that no data is ever sent to third parties. Your dashboard, devices, flows, insight and images is only transmitted between you and your Homey. Security and privacy is priority one. I cannot even see how many has logged in or uses this project.
Dashboards
In time of writing, there are no customizable dashboards available in Homey. The next best thing I’ve come across is using MQTT and NodeRED Dashboards. This project, and I emphazise project, will allow you to create custom dashboards with widgets to display and control your Homey.
Example of a dashboard displaying some basic Homey device capabilities:
Homey app certification status
Draft → Test → Published
You can get the app from the Homey App Store here: Dashboards App for Homey | Homey
Technical
This app is actually composed of two apps:
- Homey app for making the dashboard hosted from your Homey itself
- Svelte web app built as a SPA that uses the Homey Web API to access data.
Widgets
Capability
Display readonly or controllable device capabilities from your Homey.
Currently supports
- Boolean values (yes/no)
- Numeric (will display a slider if min, max and step is defined)
- Text (will display value and unit if available)
Flow
Display a simple play
button to trigger flows.
Image
Display an image registered to a device. Typically this can be a snapshot from a surveillance camera, or artwork from a chromecast device. When the image is clicked, it will open a larger view to let you see the details. As images from streams do not typically trigger an update, it is possible to select a refresh interval.
Insights
Display graphs based on Homey Insights data. It is possible to select the same resolutions as in the Homey native insights view.
Breakpoints
Four different screen sizes allow the user to customize the layout on different screen sizes. In other words; rotating the screen allows a custom layout:
Horizontal:
Vertical:
The four breakpoints are:
- 640px (6 columns)
- 768px (12 columns)
- 1024px (18 columns)
- 1280px (24 columns)
Feedback
For now, I would love to have some feedback on the project. What you would like to see implemented?
If you have any ideas for widgets, please describe the functionality and design. Any illustrations or examples would be great!