26.5

Alerter 26.5 - Timeout Fix for Custom App Icons

Alerter 26.5 fixes an annoying bug where notifications using --app-icon would ignore the --timeout flag entirely. If you've been wondering why your timed notifications were sticking around forever when paired with a custom icon, this release solves it.

What's New

• --timeout now works correctly with --app-icon. Previously, setting a custom app icon would silently break the auto-dismissal timer - the notification would stay on screen indefinitely instead of disappearing after the specified timeout. You can now combine both flags without any issues. (#62) 🙏 Merci @fbartho for your contribution !

Upgrading

Install or update via Homebrew:

brew upgrade vjeantet/tap/alerter

26.4

Alerter 26.4 — macOS Sequoia Compatibility Fix

Alerter 26.4 is a focused update that fixes a critical compatibility issue on macOS Sequoia. If your notifications were silently disappearing — or never showing up at all — this release is for you.

What's New

• Notifications now work out of the box on macOS Sequoia. macOS 15 silently drops notifications from unrecognized app identities. Alerter now defaults to the Terminal identity (com.apple.Terminal), which is always present on every Mac and has notification permissions. Say goodbye to silent failures and hanging processes. (#59)

• Improved reliability. A race condition between the timeout timer and dismissal polling has been fixed, preventing potential double-exit scenarios. Notification callbacks are now more robust and predictable.

• Normalized JSON output for --list. The JSON keys returned by --list are now lowercase (groupID, title, subtitle, message, deliveredAt) for consistency. Note: this is a breaking change if you were parsing the previous capitalized keys.

Upgrading

Install or update via Homebrew:

brew upgrade vjeantet/tap/alerter

Or via MacPorts:

sudo port upgrade alerter

If you were using --sender with a custom bundle ID, your setup is unaffected. The default has simply changed from fr.vjeantet.alerter to com.apple.Terminal.

26.3

Alerter 26.3 — Schedule It, Style It, Own It

Alerter 26.3 brings powerful new scheduling capabilities and a polished notification experience. You can now precisely control when your notifications appear, and they'll look better than ever doing it.

What's New

• Schedule notifications for later with --at — You can now deliver a notification at a specific time using --at HH:mm (fires at the next occurrence) or --at "yyyy-MM-dd HH:mm" for an exact date and time. Perfect for reminders, cron-like alerting, or time-sensitive workflows.

• Delay delivery with --delay — Need a notification to appear in a few seconds? The new --delay flag lets you defer delivery by a specified number of seconds — no external sleep command needed.

• Persistent banner-style notifications — Notifications now use the alert style by default, meaning they stay on screen until you interact with them. No more missing important alerts because a banner disappeared too quickly.

• A proper app icon — Alerter now ships with its own icon, giving your notifications a clean, recognizable look in Notification Center instead of a generic placeholder.

• Available on MacPorts — In addition to Homebrew, you can now install Alerter via MacPorts for seamless integration with your preferred package manager.

Upgrading

Install or update via Homebrew:

brew upgrade vjeantet/tap/alerter

Or via MacPorts:

sudo port upgrade alerter

Enjoy the new scheduling superpowers!

26.2

Alerter 26.2 — The Swift Era, Refined

English

Alerter has been completely rebuilt from the ground up.

Starting with version 26.0, Alerter continues to mature after its landmark rewrite in Swift. The entire codebase has been modernized, delivering a cleaner, faster, and more reliable notification experience on macOS. Whether you're building automation scripts, integrating notifications into CI/CD pipelines, or just need a quick way to send alerts from the terminal, Alerter 26.2 is ready.

What's new in the 26.x series

• Fully rewritten in Swift. Say goodbye to the legacy Objective-C implementation. Alerter now leverages Swift Package Manager and Swift Argument Parser for a modern, maintainable architecture. The result? A snappier tool with cleaner CLI syntax.

• New double-dash CLI syntax. You can now use standard CLI conventions with --message, --title, --json, and all other options. It's the command-line experience you'd expect from a modern tool.

• Install with Homebrew. We're excited to announce first-class Homebrew support! Just run brew install vjeantet/tap/alerter and you're up and running in seconds. No more manual downloads.

• Signed and notarized by Apple. Alerter is now code-signed and notarized, so macOS trusts it out of the box. No more Gatekeeper warnings, no more manual security exceptions — just install, and run.

• Proper bundle identity. Alerter now uses its own identity (fr.vjeantet.alerter) by default instead of impersonating Terminal. Your notifications look and behave exactly as they should.

• Reply, actions, JSON output, Do Not Disturb override, and more — all the features you rely on are still here, now running on a cleaner, faster engine.

1.0.1

display the correct version number

1.0.0

built with Ventura

Built on Bigsur

NEw - option to force notification when Do Not disturb is on thanks @JCsplash

catalina support

003

Merge pull request #15 from rramphal/add-installation-instructions-to…

002

output activated VALUE by default.

New -json options to get the JSON output