{"id":13588398,"url":"https://github.com/codechimp-org/ha-menu","last_synced_at":"2025-04-08T03:33:52.763Z","repository":{"id":37522290,"uuid":"157197805","full_name":"codechimp-org/ha-menu","owner":"codechimp-org","description":"A Mac OS Menu Bar app to perform common Home Assistant functions","archived":false,"fork":false,"pushed_at":"2025-01-01T14:00:44.000Z","size":11945,"stargazers_count":477,"open_issues_count":9,"forks_count":22,"subscribers_count":15,"default_branch":"master","last_synced_at":"2025-04-03T05:29:59.067Z","etag":null,"topics":["home-assistant","macos","menubar"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/codechimp-org.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"andrew-codechimp","buy_me_a_coffee":"codechimp"}},"created_at":"2018-11-12T10:41:59.000Z","updated_at":"2025-03-28T23:47:55.000Z","dependencies_parsed_at":"2024-04-13T17:40:25.994Z","dependency_job_id":"606c19fa-43ae-4792-89c1-3b58c200e842","html_url":"https://github.com/codechimp-org/ha-menu","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codechimp-org%2Fha-menu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codechimp-org%2Fha-menu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codechimp-org%2Fha-menu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/codechimp-org%2Fha-menu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/codechimp-org","download_url":"https://codeload.github.com/codechimp-org/ha-menu/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247772886,"owners_count":20993627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["home-assistant","macos","menubar"],"created_at":"2024-08-01T15:06:41.361Z","updated_at":"2025-04-08T03:33:52.429Z","avatar_url":"https://github.com/codechimp-org.png","language":"Swift","readme":"# HA Menu\n\n[![GitHub Release][releases-shield]](releases)\n[![Downloads][download-latest-shield]](Downloads)\n[![License][license-shield]](LICENSE)\n\n![Logo](https://github.com/codechimp-org/ha-menu/blob/master/Art/logo.png)\n\nA Mac OS Menu Bar app to perform common Home Assistant functions  \nCurrently HA Menu supports  \n* Turning available switches, lights, automations and input_boolean's on and off\n* Activating scenes, scripts, buttons and input_buttons\n* input_select option menus  \n* Opening and Closing Covers\n* Viewing sensor values (Sensors have to be specifically added to a group)  \n\nHA Menu supports MacOS 11.5 (Big Sur) and later.\n\n![alt text](Art/menu.png \"HA Menu\")\n\n## Installation\n**Manual**  \nGet the latest HA.Menu.zip from [Releases](https://github.com/codechimp-org/ha-menu/releases)  \nUnzip and copy the HA Menu app to your Applications folder\n\n**Homebrew Cask**  \n2.6 or later ```brew install --cask ha-menu```  \n2.5 or earlier ```brew cask install ha-menu```\n\n## Configuration\nYou will have needed to enable Allow app's downloaded from App Store and identified developers enabled in Security \u0026 Privacy Settings to run.  \n\nFor 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.\n\nTo create a token within HA, login to HA and click on your profile.  \nUnder Long Lived Access Tokens, create a new token, give it a name and copy the token value into HA Menu preferences.\n\nPress Connect to validate your connection and get your groups.  You can now choose which domains/groups to display within HA Menu, drag them to reorder and optionally make them a submenu.\n\n![alt text](Art/preferences.png \"Preferences\")\n\n### Domains\n\nWithin 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.  \nIf you want to display just a few items from a domain, create a custom group as detailed below.   \nEntities within domains are displayed alphabetically.\n\n### Groups\n\nIf you have a lot of entities within your domains you can have HA Menu display a specific set by [creating new groups within HA](https://www.home-assistant.io/integrations/group/).  \nYou can create multiple groups and they will be separated within the drop down menu.\n\nFirst 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.\n\nOnce you have the group(s) added to HA, within HA Menu go to Preferences and tick the Groups you want to be displayed.   \nClose preferences to save these settings.\n\nNow when you click on HA Menu again the group's you have setup will be displayed.  Entities within groups are displayed in the order they are added within the group (printer, lego_lights, desk_lamp, notifications, entry_alert, who_cooks, outside_temperature in the example).  \n\nWhere sensors are included they will be displayed with a bullet in the menu, and show the friendly name, state/value and unit of measurement. Clicking on a sensor does not perform any action.   \n\nExample groups.yaml\n```yaml\nha_menu:\n  name: HA Menu Switches\n  entities:\n    - switch.printer\n    - switch.lego_lights\n    - light.desk_lamp\n    - input_boolean.notifications\n    - automation.entry_alert\n    - input_select.who_cooks\n    - sensor.outside_temperature\n```\n\n## Say Thanks\nIf you would like to show your support for HA Menu\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png)](https://www.buymeacoffee.com/codechimp)\n\n[license-shield]: https://img.shields.io/github/license/codechimp-org/ha-menu.svg?style=for-the-badge\n[releases-shield]: https://img.shields.io/github/release/codechimp-org/ha-menu.svg?style=for-the-badge\n[download-latest-shield]: https://img.shields.io/github/downloads/codechimp-org/ha-menu/latest/total?style=for-the-badge\n","funding_links":["https://github.com/sponsors/andrew-codechimp","https://buymeacoffee.com/codechimp","https://www.buymeacoffee.com/codechimp"],"categories":["Swift"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodechimp-org%2Fha-menu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcodechimp-org%2Fha-menu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcodechimp-org%2Fha-menu/lists"}