dorkhub

notificator

Trigger macOS notifications from Alfred, using the Workflow icon

vitorgalvao
Shell19116 forksUnlicenseupdated 10 months ago
git clone https://github.com/vitorgalvao/notificator.gitvitorgalvao/notificator

Notificator

Notificator is a command-line tool to show notifications from Alfred Workflows with their icon.

Screenshot 2025-04-01 at 21 32 19 Screenshot 2025-04-01 at 21 32 33

Installation

Download the executable at the root of this repository and include it in your workflow.

Usage

Trigger macOS notifications from Alfred, using the Workflow icon.

Message is mandatory. Other flags are optional.

Usage:
  notificator --message <text> [--title <text>] [--subtitle <text>] [--sound <name>]

Options:
  -m, --message <text>    Message text.
  -t, --title <text>      Title text.
  -s, --subtitle <text>   Subtitle text.
  -p, --sound <name>      Sound name (from /System/Library/Sounds).
  -h, --help              Show this help.

How it works

While 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. Notificator’s purpose is to create these small specialised apps.

The icon is extracted from the Workflows’s root directory and the bundle identifier is based on the Workflow’s. The 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 the Workflow icon was modified since the last run.

Prohibitory Symbol

A macOS bug may cause notifications to show a prohibitory symbol on top of the app icon. Logout or restart macOS to fix it.

more like this

agentlytics

Comprehensive analytics dashboard for AI coding agents — Cursor, Windsurf, Claude Code, VS Code Copilot, Zed, Antigravi…

JavaScript555
@f

r2

Free open-source Cloudflare R2 desktop client and S3 GUI for macOS, Windows, and Linux. Manage Cloudflare R2, AWS S3, M…

TypeScript50

search

search projects, people, and tags