Gnome Extension

A simple GNOME Shell extension to interact with your local Home Assistant instance.

Installation

0. Install Mosquitto client:

   sudo apt install mosquitto-clients

1. Clone this repo:

   git clone https://github.com/aprilborn/ha-quick-settings.git

2. Copy to extensions directory:

   mv ha-quick-settings ~/.local/share/gnome-shell/extensions/home-assistant@local

3. Restart GNOME Shell:

   • Press Alt + F2, type r and press Enter (on Xorg), or log out and log in again.

4. Enable the extension:

   • Use GNOME Extension Manager app or gnome-extensions enable home-assistant@local.

5. Enable retain messages:

   • Home Assistant -> Z2M addon page -> Target device -> Settings -> ✓ Retain

Usage

• Open Extension Manager
• Configure extension:
  • MQTT URL
  • MQTT Username
  • MQTT Password
  • MQTT topics ( for 1st button)
  • Webhook URL (for 2nd button)
  • Slider topic
  • MQTT button label
  • Webhook button label
• Enable/Re-enable extension.
• Open Quick Settings to see new buttons and slider.

Development

• The entry point is extension.js.
• Make edits and reload GNOME Shell to see changes.
• For troubleshooting, see logs with:

  journalctl /usr/bin/gnome-shell -f -o cat

License

MIT

---

Questions, suggestions, or contributions welcome! Open an issue or submit a PR.