{"id":24044469,"url":"https://github.com/kukuxx/ha-notifyhelper","last_synced_at":"2026-01-20T00:01:27.437Z","repository":{"id":263056379,"uuid":"889203984","full_name":"kukuxx/HA-NotifyHelper","owner":"kukuxx","description":"Home Assistant custom integration for notification./Home Assistant 通知助手整合","archived":false,"fork":false,"pushed_at":"2025-04-29T21:57:04.000Z","size":6672,"stargazers_count":11,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-23T03:54:09.878Z","etag":null,"topics":["custom-components","home-assistant","homeassistant","homeassistant-components","homeassistant-custom-component","homeassistant-integration","notification","notifier"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kukuxx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2024-11-15T20:13:39.000Z","updated_at":"2025-08-03T07:24:19.000Z","dependencies_parsed_at":"2024-11-15T21:30:22.942Z","dependency_job_id":"11a2aa03-8eb2-4bcf-9030-db88acc2008f","html_url":"https://github.com/kukuxx/HA-NotifyHelper","commit_stats":null,"previous_names":["kukuxx/ha-app_notification","kukuxx/ha-notificationhelper","kukuxx/ha-notifyhelper"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/kukuxx/HA-NotifyHelper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kukuxx%2FHA-NotifyHelper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kukuxx%2FHA-NotifyHelper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kukuxx%2FHA-NotifyHelper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kukuxx%2FHA-NotifyHelper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kukuxx","download_url":"https://codeload.github.com/kukuxx/HA-NotifyHelper/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kukuxx%2FHA-NotifyHelper/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28590676,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T23:59:00.777Z","status":"ssl_error","status_checked_at":"2026-01-19T23:58:54.030Z","response_time":67,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["custom-components","home-assistant","homeassistant","homeassistant-components","homeassistant-custom-component","homeassistant-integration","notification","notifier"],"created_at":"2025-01-08T23:31:15.320Z","updated_at":"2026-01-20T00:01:27.393Z","avatar_url":"https://github.com/kukuxx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n [![Contributors][contributors-shield]][contributors-url]\n [![Forks][forks-shield]][forks-url]\n [![Stargazers][stars-shield]][stars-url]\n [![Issues][issues-shield]][issues-url]\n [![License][license-shield]][license-url]\n\n [contributors-shield]: https://img.shields.io/github/contributors/kukuxx/HA-NotifyHelper.svg?style=for-the-badge\n [contributors-url]: https://github.com/kukuxx/HA-NotifyHelper/graphs/contributors\n\n [forks-shield]: https://img.shields.io/github/forks/kukuxx/HA-NotifyHelper.svg?style=for-the-badge\n [forks-url]: https://github.com/kukuxx/HA-NotifyHelper/network/members\n\n [stars-shield]: https://img.shields.io/github/stars/kukuxx/HA-NotifyHelper.svg?style=for-the-badge\n [stars-url]: https://github.com/kukuxx/HA-NotifyHelper/stargazers\n\n [issues-shield]: https://img.shields.io/github/issues/kukuxx/HA-NotifyHelper.svg?style=for-the-badge\n [issues-url]: https://github.com/kukuxx/HA-NotifyHelper/issues\n\n [license-shield]: https://img.shields.io/github/license/kukuxx/HA-NotifyHelper.svg?style=for-the-badge\n [license-url]: https://github.com/kukuxx/HA-NotifyHelper/blob/main/LICENSE\n\n![image](/doc/icon.png)\n\n# HA-Notifyhelper\n\n- [English](/README.md) | [繁體中文](/doc/README-zh-TW.md)\n\n\u003e This is a \u003cb\u003eHome assistant custom integration\u003c/b\u003e, It allows you to send notifications to all mobile devices of a person at once and display notifications on a custom Lovelace card, and supports the configuration of multi-person exclusive notification card.\n\n\u003e Thanks to \u003cb\u003eMark Wu\u003c/b\u003e for some ideas and tests.\n\n\u003e [!Tip]\n\u003e If you keep getting notifications for old pictures or videos, please see \n\u003ca href='https://community.home-assistant.io/t/home-assistant-sends-cached-images-in-ios-notification/520766'\u003ehere.\u003c/a\u003e\n\n\u003e [!Tip]\n\u003e If you encounter a bug during use, \u003cbr\u003e\n\u003e please enable \u003cb\u003edebug mode\u003c/b\u003e in the integration and try the original operation, \u003cbr\u003e\n\u003e then open issues and post the log.\n\n## Changelog\n\n\u003e [CHANGELOG](/CHANGELOG.md)\n\n## Instructions for use  \n\n- It is recommended to use \u003cb\u003eHACS\u003c/b\u003e to install. If you want to install manually,\n  \u003cbr\u003eplease put the \u003cb\u003enotifyhelper\u003c/b\u003e folder in \u003cb\u003ecustom_components\u003c/b\u003e folder, \n  \u003cbr\u003eand restart \u003cb\u003eHome assistant\u003c/b\u003e.\n\n  [![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=kukuxx\u0026repository=HA-NotifyHelper\u0026category=Integration)\n\n- After the restart is completed, search for notifyhelper in the integration and set it up:\u003cbr\u003e\n![image](/doc/settings.png)\n\n\u003e [!Tip]\n\u003e Only \u003cb\u003e500\u003c/b\u003e notifications can be saved.\u003cbr\u003e\n\u003e If more than \u003cb\u003e500\u003c/b\u003e notifications are stored,\n\u003e \u003cbr\u003ethey will be \u003cb\u003edeleted\u003c/b\u003e starting from the \u003cb\u003eoldest one\u003c/b\u003e.\n\n- The method of calling the service is similar to the built-in notify.mobile_app service.\n  \u003cbr\u003eThe following is an automation example:\n```\n    alias: test1\n    description: \"\"\n    triggers:\n    - trigger: event\n        event_type: \"\"\n    conditions: []\n    actions:\n    - sequence:\n        - action: notify.notify_person\n            data:\n                title: Test Notification\n                message: This is a test message.\n                targets:\n                    - person.you\n                    - person.other\n                color:\n                data:\n                    image: /local/icon.png\n    mode: single\n```\n\u003e [!Important]\n\u003e \u003cb\u003eThe iOS badge is automatically configured and requires no manual setup. The URL can be specified during integration setup, but any URL defined in automation will override the default.\u003c/b\u003e\n\n\u003e [!Tip]\n\u003e \u003cb\u003etargets: \u003ci\u003emust be a list.\u003c/i\u003e\u003c/b\u003e\u003cbr\u003e\n\u003e \u003cb\u003ecolor: \u003ci\u003eOptional, specify the message color please fill in Hex rgb,\n\u003e the default is None.\u003c/i\u003e\u003c/b\u003e\u003cbr\u003e\n\u003e \u003cb\u003edata: \u003ci\u003eOptional, Refer to \u003ca href='https://companion.home-assistant.io/docs/notifications/notifications-basic'\u003eHA doc.\u003c/a\u003e\u003c/i\u003e\u003c/b\u003e\u003cbr\u003e\n\n\n- The data parameters accepted by Android and ios are different, if you want to set them separately, you can add \u003cb\u003eios\u003c/b\u003e and \u003cb\u003eandroid\u003c/b\u003e to the data.\n\u003cbr\u003eThe following is an automation example:\n```\n    alias: test1\n    description: \"\"\n    triggers:\n    - trigger: event\n        event_type: \"\"\n    conditions: []\n    actions:\n    - sequence:\n        - action: notify.notify_person\n            data:\n                title: Test Notification\n                message: This is a test message.\n                targets:\n                    - person.you\n                    - person.other\n                color: \n                data:\n                  ios:\n                    image: /local/icon.png\n                    push:\n                        sound:\n                        name: US-EN-Morgan-Freeman-Roommate-Is-Arriving.wav\n                        volume: 0.3\n                        critical: 1\n                  android:\n                    image: /local/icon.png\n    mode: single\n```\n\n\u003e [!Tip]\n\u003e \u003cb\u003eIf the set parameters are all universal,\nyou can use the first example without adding ios and android.\u003cbr\u003e\n\u003e You can send different photos or videos for ios and android but the notification will only save one of them, please be aware of this. \u003c/b\u003e\n\n- Notifications card configuration:\n```\n    type: custom:notifications-card\n    person_name:  // yourname, e.g.:John\n    font_size: optional       // text size, default 16px\n    line_height: optional    // line spacing ratio, default 1.0\n\n```\n\n- Button card configuration:\n```\n    show_name: true\n    show_icon: true\n    type: button\n    tap_action:\n        action: perform-action\n        perform_action: notifyhelper.read\n        target: {}\n        data:\n            targets:\n                - person.you\n```\n\u003e [!Tip]\n\u003e \u003cb\u003etargets: \u003ci\u003emust be a list.\u003c/i\u003e\u003c/b\u003e\n\n\u003e [!NOTE]\n\u003e You don’t necessarily need to create a button card to mark notifications as read.\u003cbr\u003e\n\u003e You can also use automation to call the service.\u003cbr\u003e\n\u003e The same applies to clear notifications.\u003cbr\u003e\n\u003e Please configure it according to your personal needs.\n\n## Achievements Display   \n\n![gif](/doc/display.gif)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkukuxx%2Fha-notifyhelper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkukuxx%2Fha-notifyhelper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkukuxx%2Fha-notifyhelper/lists"}