https://github.com/cassidyjames/butler

Home Assistant companion app for Linux
https://github.com/cassidyjames/butler

adwaita flathub flatpak gnome gtk gtk4 hacktoberfest home-assistant libadwaita meson vala

Last synced: about 2 months ago
JSON representation

Home Assistant companion app for Linux

• Host: GitHub
• URL: https://github.com/cassidyjames/butler
• Owner: cassidyjames
• License: gpl-3.0
• Created: 2024-01-03T22:44:53.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-19T14:46:44.000Z (8 months ago)
• Last Synced: 2025-03-15T09:08:32.074Z (2 months ago)
• Topics: adwaita, flathub, flatpak, gnome, gtk, gtk4, hacktoberfest, home-assistant, libadwaita, meson, vala
• Language: Vala
• Homepage: https://cassidyjames.com
• Size: 1.98 MB
• Stars: 107
• Watchers: 3
• Forks: 2
• Open Issues: 22
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Only on Flathub](https://img.shields.io/badge/Only_on_Flathub-white?logo=flathub&logoColor=white&labelColor=black)][Only on Flathub]

[![Installs](https://img.shields.io/flathub/downloads/com.cassidyjames.butler?label=Installs)][Flathub]

[![Please do not theme this app](https://stopthemingmy.app/badge.svg)](https://stopthemingmy.app)

![Icon](data/icons/release.svg?raw=true)

# Butler

**Companion for Home Assistant**

![Screenshot](data/screenshots/light.png)

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.

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](https://wiki.gnome.org/Foundation/CodeOfConduct).



## 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](data/icons/devel.svg?raw=true)

I recommend using GNOME Builder for development.

[Only on Flathub]: https://cassidyjames.com/apps#only-on-flathub

[Flathub]: https://flathub.org/apps/details/com.cassidyjames.butler