@app_id@ CC-BY-SA-4.0 GPL-3.0-or-later @app_name@ Companion for Home Assistant #7fd6ff #027bb3 Cassidy James Blaede Cassidy James Blaede

Access your Home Assistant dashboard from a native companion UI, integrating better with your OS. Native features include:

Butler is designed to make getting at your Home Assistant dashboard easier for kiosks, your laptop/desktop, or your Linux phone. It does not currently support companion app features from Android and iOS like location services, notifications, or exposing device sensors—if you’d like to add those features, please check out the website to contribute!

Other features include:

Note WebRTC camera streams (i.e. used by some newer Nest cameras) are not currently supported.

 @app_id@ @app_id@.desktop 360 pointing keyboard touch https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/light.png Home Assistant dashboard with many rooms and devices https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/light-settings.png Available settings, including server URL and custom header colors https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/dark.png Home Assistant dashboard in dark style https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/dark-settings.png Available settings in dark style https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/light-mobile.png Home Assistant dashboard with many rooms and devices https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/light-mobile-settings.png Available settings, including server URL and custom header colors https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/dark-mobile.png Home Assistant dashboard in dark style https://raw.githubusercontent.com/cassidyjames/butler/8bab9d361e7924cd0f2fdbf214a6e1a3e846fdec/data/screenshots/dark-mobile-settings.png Available settings in dark style

Quality of life improvements

  • Files can now be downloaded!
  • New zoom item in menu
  • Warning when the server doesn’t look like Home Assistant
  • Fixed how server URLs are saved and restored at startup
  • Attempt to fix a crash on older hardware by no longer forcing hardware acceleration
  • Under-the-hood change to make testing easier on more devices
 Allow saving/downloading files Add zoom to menu Possible to set non-HA URLs as server URL URL confusion when using a wrong URL for a server App crash - jump to invalid address aarch64 builds in CI

Quality of life improvements

  • Files can now be downloaded!
  • New zoom item in menu
  • Warning when the server doesn’t look like Home Assistant
  • Fixed how server URLs are saved and restored at startup
  • Attempt to fix a crash on older hardware by no longer forcing hardware acceleration
 Allow saving/downloading files Add zoom to menu Possible to set non-HA URLs as server URL URL confusion when using a wrong URL for a server App crash - jump to invalid address

Expressive refresh

  • Completely reworked adaptive UI coloring behind “expressive” preference
  • Thinner titlebar style for less wasted space
  • New “reload” menu item for those times your dashboard isn’t cooperating
  • Prettier error handling with relevant next steps
  • Updated the default header colors to the latest Home Assistant theme
  • Under-the-hood refactoring for improved performance and maintainability
 Butler loses connection on resume from suspend

GNOME 49 “Brescia”

  • Adaptive look for native UI based on header colors
  • Updated with the latest GNOME 49 platform and design
  • Updated the default header colors to the latest Home Assistant theme
  • Removed Ctrl+F from fullscreen shortcuts since it conflicts with Find
 Remap ctrl-f full screen shortcut key

GNOME 47 “Denver”

  • Updated with the latest GNOME 47 platform and design
  • Matched the default dark header color to the Home Assistant dark theme
  • Reworked adaptive “Settings” dialog with individually-resettable options
  • Improved reliability of saving server URLs

The Rise of Settings

  • New “Settings” dialog where you can set your server URL, and more…
  • New “Header Bar Color” setting where you can customize the background color of the top bar, including different colors for light and dark styles

Under the hood

  • Separate development and release profiles to make development easier
 Regarding header bar in dark mode

Improved app listing

  • Improved light brand color for Flathub and app store clients
  • Updated screenshots

Improved brand colors for Flathub and app store clients

GNOME 46

  • Target GNOME 46 runtime
  • Improved dialogs using new Adwaita widgets
  • Improved light brand color for Flathub and app store clients

Improved app listing

  • Refreshed icon with better contrast thanks to Tobias Bernard
  • Brand colors for Flathub and app store clients
 Icon lacks contrast (too dark)

Improved app listing

  • New icon based on Jakub Steiner's excellent work
  • Refreshed summary and description to better align with Flathub recommendations
 MetaInfo: failing summery length Unique icon

Small improvements

  • Show a banner about the demo server
  • Open links in default browser
  • Automatically prepend protocol to custom server if omitted
  • Improved about window
  • Start preparing for translations
 Better onboarding Open links in default browser Automatically prepend protocol to custom server if omitted

Improved accessibility and fullscreen experience

  • Hide header bar when fullscreen
  • Remember fullscreen state
  • Remind how to exit fullscreen
  • Add access keys (mnemonics) for better accessibility
 Hide header bar when fullscreen Remember fullscreen state Remind how to exit fullscreen Add access keys (mnemonics) for better accessibility

Initial release

 mild https://github.com/cassidyjames/butler https://github.com/cassidyjames/butler/issues https://github.com/cassidyjames/butler https://cassidyjames.com/pay https://cassidyjames.com/support