Skip to content

cassidyjames/butler

Repository files navigation

Only on Flathub Installs Please do not theme this app

Icon

Butler

Companion for Home Assistant

Screenshot

Hybrid native + web app for Home Assistant. Butler wraps your Home Assistant dashboard up in a native UI, integrating better with your OS. Native features include:

  • Icon in your App Grid, Applications Menu, Dash, Dock, etc.
  • Native header bar
  • Save and restore current view and size when closed and re-opened
  • Two-finger swipe and mouse button support to go back/forward between views
  • Cross-desktop light/dark style support for GNOME, elementary OS, etc.

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, you're in the right place!

Other features include:

  • Pinch-to-zoom
  • Set the scaling with Ctrl+Plus/Minus or Ctrl+0 to reset

Made for GNOME

Butler is designed and developed on and for GNOME. As such, contributors agree to abide by the GNOME Code of Conduct.

Download on Flathub

Why not a web browser or PWA?

I don't love the state of web apps and PWAs on Linux; I prefer GNOME Web or Firefox, but the former doesn't truly support PWAs (just web apps with not-that-lightweight of a UI) and the latter doesn't support PWAs on the desktop at all. So, I made this dumb little web wrapper to give myself a bit more integrated of an experience.

If there's more interest in making this into a better-integrated companion app for Linux, I welcome contributions!

Developing and Building

Icon

I recommend using GNOME Builder for development.