{"id":13479273,"url":"https://github.com/vitorgalvao/notificator","last_synced_at":"2025-08-19T22:32:05.570Z","repository":{"id":11500370,"uuid":"13977615","full_name":"vitorgalvao/notificator","owner":"vitorgalvao","description":"Trigger macOS notifications from Alfred, using the Workflow icon","archived":false,"fork":false,"pushed_at":"2024-05-17T12:56:27.000Z","size":89,"stargazers_count":169,"open_issues_count":0,"forks_count":14,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-12-11T19:17:00.213Z","etag":null,"topics":["alfred","jxa","macos","notifications","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vitorgalvao.png","metadata":{"files":{"readme":"README.md","changelog":null,"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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.paypal.me/vitorgalvao"]}},"created_at":"2013-10-30T04:51:32.000Z","updated_at":"2024-11-25T02:46:50.000Z","dependencies_parsed_at":"2024-05-17T13:54:45.319Z","dependency_job_id":"2b3226ca-3136-4ac4-bcc8-16d2958bdf4d","html_url":"https://github.com/vitorgalvao/notificator","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorgalvao%2Fnotificator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorgalvao%2Fnotificator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorgalvao%2Fnotificator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vitorgalvao%2Fnotificator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vitorgalvao","download_url":"https://codeload.github.com/vitorgalvao/notificator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230374118,"owners_count":18216041,"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":["alfred","jxa","macos","notifications","zsh"],"created_at":"2024-07-31T16:02:12.594Z","updated_at":"2025-08-19T22:32:05.562Z","avatar_url":"https://github.com/vitorgalvao.png","language":"Shell","funding_links":["https://www.paypal.me/vitorgalvao"],"categories":["Shell"],"sub_categories":[],"readme":"# Notificator\n\nNotificator is a command-line tool to show notifications from [Alfred](https://www.alfredapp.com) Workflows with their icon.\n\n\u003cimg width=\"370\" alt=\"Screenshot 2025-04-01 at 21 32 19\" src=\"https://github.com/user-attachments/assets/aaedb77e-186e-4a29-b658-bef5589f9f28\" /\u003e\n\n\u003cimg width=\"370\" alt=\"Screenshot 2025-04-01 at 21 32 33\" src=\"https://github.com/user-attachments/assets/3d5b046b-518a-43de-98a8-f88ba9b9ba65\" /\u003e\n\n## Installation\n\nDownload the executable at the root of this repository and include it in your workflow.\n\n## Usage\n\n```\nTrigger macOS notifications from Alfred, using the Workflow icon.\n\nMessage is mandatory. Other flags are optional.\n\nUsage:\n  notificator --message \u003ctext\u003e [--title \u003ctext\u003e] [--subtitle \u003ctext\u003e] [--sound \u003cname\u003e]\n\nOptions:\n  -m, --message \u003ctext\u003e    Message text.\n  -t, --title \u003ctext\u003e      Title text.\n  -s, --subtitle \u003ctext\u003e   Subtitle text.\n  -p, --sound \u003cname\u003e      Sound name (from /System/Library/Sounds).\n  -h, --help              Show this help.\n```\n\n## How it works\n\nWhile it is possible to trigger notifications from AppleScript, those show a generic icon. To have a custom icon in full view, an app is required.\n\nNotificator’s purpose is to create these small specialised apps. The icon is extracted from the Workflows’s root directory and the bundle identifier is derived from the Workflow’s—it is cleaned up and `.notificator` is appended.\n\nThe first time the script is run on a user’s machine, the app is seamlessly created to the Workflow’s cache directory and macOS prompts the user to allow notifications. On subsequent runs, the cached app is run directly. The app is rebuilt if it is over a month old at the time of the notification, to refresh outdated icons.\n\n## Prohibitory Symbol\n\n[A macOS bug](https://web.archive.org/web/20230615021755/https://macmule.com/2021/10/28/notifications-showing-a-prohibitory-symbol-after-upgrading-macos-monterey/) may cause notifications to show a prohibitory symbol on top of the app icon. Logout or restart macOS to fix it.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitorgalvao%2Fnotificator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvitorgalvao%2Fnotificator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvitorgalvao%2Fnotificator/lists"}