Skip to content
A Mac OS Menu Bar app to perform common Home Assistant functions
Swift Rich Text Format
Branch: master
Clone or download

README.md

Logo

HA Menu

A Mac OS Menu Bar app to perform common Home Assistant functions
Currently HA Menu supports turning available switches, lights, automations and input_boolean's on and off. Plus input_select option menus. HA Menu supports MacOS 10.13 (High Sierra) and later.

alt text

Installation

Manual
Get the latest HA.Menu.zip from Releases
Unzip and copy the HA Menu app to your Applications folder

Homebrew Cask
brew cask install ha-menu

Configuration

You will have needed to enable Allow app's downloaded from App Store and identified developers enabled in Security & Privacy Settings to run.

For the server connection you can use your local ip:port as per the example, an external facing address you have setup via DuckDNS or similar, or your Nabu Casa URL. Ensure you prefix with http:// or https:// as appropriate.

To create a token within HA, login to HA and click on your profile. Under Long Lived Access Tokens, create a new token, give it a name and copy the token value into HA Menu preferences.

alt text

Domains

Within the preference screen you can choose which domains to display. Domains are a list of all entities within that domain, e.g. Lights will display all lights within HA Menu.
If you want to display just a few items from a domain, create a custom group as detailed below.
Entities within domains are displayed alphabetically.

Groups

If you have a lot of entities within your domains you can have HA Menu display a specific set by creating new groups within HA.
You can create multiple groups and they will be separated within the drop down menu.

First of all create your group(s) within groups.yaml as per the example. Note the group entity id is ha_menu in this example. Validate and Reload Groups within HA (Configuration/Server Controls) to have the group added to HA. If you want multiple groups just repeat the block and rename the entity id/name and change your entity's.

Once you have the group(s) added to HA, within HA Menu go to Preferences and within the Groups field enter the group entity ID's you want to be displayed (ha_menu in this example). If you have created multiple groups you can comma separate their entity ID's e.g. ha_menu,my_automations,living_room Close preferences to save these settings.

Now when you click on HA Menu again the group's you have setup will be displayed. The groups are displayed in the order you entered them into preferences, entities within groups are displayed in the order they are added within the group (printer, lego_lights, desk_lamp, notifications, entry_alert, who_cooks in the example).

Example groups.yaml

ha_menu:
  control: hidden
  view: no
  name: HA Menu Switches
  entities:
    - switch.printer
    - switch.lego_lights
    - light.desk_lamp
    - input_boolean.notifications
    - automation.entry_alert
    - input_select.who_cooks

Say Thanks

If you like HA Menu buy me a ☕️ via PayPal

You can’t perform that action at this time.