NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #3789 most downloaded on npm
A Node.js module for sending notifications on native Mac, Windows (post and pre 8) and Linux (or Growl as fallback)
Latest stable
12.1.0
Last release 21 days ago
31 Oct 2026
Ships unpredictably
gaps range from 3 weeks to 4.7 years
Most releases are documented
notes for 50 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
14 years old
76 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
feat: rewrites to typescript and ships types by @mikaelbr in https://github.com/mikaelbr/node-notifier/pull/476
Full Changelog: https://github.com/mikaelbr/node-notifier/compare/v12.0.0...v12.1.0
Features:
@types/node-notifier is no longer needed. Each notifier has typed options (NotificationCenterNotification, WindowsToasterNotification, WindowsBalloonNotification, NotifySendNotification, GrowlNotification), and the notifier classes can be used as types, e.g. const nc: NotificationCenter = new NotificationCenter().Migrating from @types/node-notifier:
@types/node-notifier. TypeScript uses the bundled types once they're installed and ignores it.NotificationCenter.Notification with NotificationCenterNotification, NotifySend.Notification with NotifySendNotification, and NodeNotifier with DefaultNotifier. NotificationCallback, NotificationMetadata and NotifierOptions (DT's Option) are exported by name.time for notify-send) still work at runtime, but need a cast.Fixes:
WindowsBalloon with wait no longer throws when notifu exits without an error code.NotifySend.notify returns the notifier when notify-send isn't found, instead of undefined.Internal:
dist/, which is what's published together with vendor/. The public entry points (node-notifier and node-notifier/notifiers/*) are unchanged.import, require and TypeScript.pnpm test no longer runs the linter first. Use pnpm lint.Your coding agent can read these notes before it upgrades. Set up the MCP server →
feat: updates to terminal-notifier v3 with Apple silicon support by @mikaelbr in https://github.com/mikaelbr/node-notifier/pull/463
Full Changelog: https://github.com/mikaelbr/node-notifier/compare/v11.0.0...v12.0.0
Breaking changes:
node-notifier is now ES modules only ("type": "module"). Use import notifier from 'node-notifier', or named exports like import { notify, NotificationCenter } from 'node-notifier'. require('node-notifier') keeps working through Node's require(esm) and returns the same notifier instance as before, and require('node-notifier/notifiers/<name>') still returns the notifier class.exports map. Only the root and node-notifier/notifiers/* can be imported; internal files such as node-notifier/lib/utils are no longer reachable.terminal-notifier 3.0.0, which runs natively on Apple silicon (#361, #441). To migrate:
withFallback: true for Growl on older versions).wait, timeout and the click/timeout events only work with actions or reply. Add actions if you need to wait for the user.icon, sender, closeLabel and dropdownLabel are ignored. Use customPath with your own build for a custom icon.contentImage must be a local file.deliveredAt/activationAt.Features:
actions to NotifySend, using the action buttons in notify-send (libnotify) 0.7.10+ (#445). The notification waits for the user, choosing an action emits click with the label as metadata.activationValue, and running out of time emits timeout, the same as macOS.NODE_NOTIFIER_WSL_NOTIFIER=linux to use NotifySend instead of WindowsToaster for the default notifier, e.g. when running an X server with a notification daemon (#412). It must be set before node-notifier is imported. Unset, WSL keeps using WindowsToaster.duration: 'short' | 'long' to WindowsToaster, passed to SnoreToast as -d, to keep a toast on screen for about 25 seconds instead of about 7 (#401, #223). Other values are dropped, and wait/timeout are unchanged. x64 only with the bundled binary, as the bundled 32-bit SnoreToast (0.7.0) lacks -d. On other architectures it is dropped unless customPath is set.transient to NotifySend. transient: true passes --hint=int:transient:1, so the notification isn't kept in the notification list (e.g. GNOME Shell), and can be combined with hint (#188).application to WindowsToaster, passed to SnoreToast as -application, so clicking a notification after node-notifier has stopped listening (e.g. from the action center) starts your app (#430).Fixes:
icon paths on Windows drives (/mnt/c/...) and skips other icons instead of showing an empty "SnoreToast" notification (#354).WindowsToaster now accepts remove without a message, the same as close (#431).appID (#326, #332, #375). The binary is KDE's own build of the official release. The 32-bit binary stays on 0.7.0, as KDE publishes no 32-bit build. Note that the new binary is not code-signed.notify throwing in cluster worker processes (#410).Internal:
EventEmitter (they can still be called without new).files allowlist instead of .npmignore, and drops the outdated nexe example build scripts.vitest explicitly instead of relying on globals.terminal-notifier is checked against the release checksum in CI (scripts/vendor-terminal-notifier.sh).scripts/vendor-snoretoast.sh).vendor/snoreToast/README.md (#381).Thanks to @Sebastian-Webster for the original Apple silicon work in #441, to @DuBistKomisch for finding and fixing the SnoreToast appID issue in #375 and upstream, and to @marmul for the original notify-send actions work in #445.
Even though this is a major version, there are no real breaking changes for most people. This removes uneeded external dependencies and updates the in…
Even though this is a major version, there are no real breaking changes for most people. This removes uneeded external dependencies and updates the internal dependencies to the latest versions.
But it now only checks and verifies node versions 20.x, 22.x, 24.x. So if you are on older versions, this might break.
There will be an upcoming major version that has bigger breaking changes, so this is an intermediate major version to clean up the codebase and dependencies.
Features:
clearAll() to NotificationCenter to stop waiting on active notifications, so the application can exit without waiting for their timeouts. See #210Fixes:
WindowsToaster works under WSL. See #458Thanks to @mtsmfm
Fix custom path for windows #382
Setting NSAllowsArbitraryLoads as false for security reasons within terminal-notifier. Meaning non-https images/loads for terminal-notifier will no lo
Fixes potential security issue with non-escaping input parameters for notify-send.
Corrects mapping on snoretoast activate event. See #347.
Fixes potential security issue with non-escaping input parameters for notify-send.
Nothing published for this version
Expire time for notify-send is made to match macOS and Windows with default time of 10 seconds. The API is changed to take seconds as input and conver
Breaking changes:
Fixes issue with haning Windows notifications when disabled
Fixes import of uuid, removes deprecation warnings
NotifySend support for app-name (#299, see docs)
Dropped support for node v6. As of v6 we currently support node versions 8, 10, and 12 (latest).
wait option in that environment as it is now always on. Prepares the way for other new features added to the WindowsToaster.Nothing published for this version
Fixes potential security issue with non-escaping input parameters for notify-send.
Fixes potential security issue with non-escaping input parameters for notify-send.
- Updates dependencies
Reverts changes to default timeout as they are causing some issues. See #271
Prevent Spotlight from indexing terminal-notifier.app
- Re-adds notifu update.
notifu update.Rollback notifu update as it triggered Avast virus scan.
notifu update as it triggered Avast virus scan.Updates terminal-notifier dependency to v1.7.2, fixing memory leak. But not to v1.8.0 as this breaks how icons work.
Updates terminal-notifier dependency to v1.7.2, fixing memory leak. But not to v1.8.0 as this breaks how icons work.
Updates notifu with new subtitle "Notification"
Fix: issue with appID by removing default empty string (see README Windows section)
Fix: link notifier time property to notify-send expire-time flag
Minor change: use a more specific condition for enabling debug logging (#171)
Adds temporary workaround for terminal-notifier memory leak as seen in https://github.com/facebook/jest/issues/2999 and https://github.com/julienXX/te
terminal-notifier memory leak as seen in https://github.com/facebook/jest/issues/2999 and https://github.com/julienXX/terminal-notifier/issues/173.Non-obligatory fail. Fixes issue with multiple actions for macOS.
Non-obligatory fail. Fixes issue with multiple actions for macOS.
Obligatory fail. Fixes minor issue with non-JSON output for macOS.
Obligatory fail. Fixes minor issue with non-JSON output for macOS.
_Note/TL;DR_: If you are just using node-notifier with things like message, title and icon, v5 should work just as before.
Note/TL;DR: If you are just using node-notifier with things like message, title and icon, v5 should work just as before.
notify bin when installing node-notifier. To get this do npm i [-g] node-notifier-clitoast.exe to Snoretoast. This means if you are using your custom fork, you need to change. SnoreToast has some better default implemented functionality.v1.7.1. With that there can be changes in the API, and supports now reply and buttons. Output has changed to JSON by default, this means the output of some functions of the terminal-notifier has broken. See https://github.com/julienXX/terminal-notifier for more details. See README for documentation on how to use the new features, or an example file.notify method will now throw error if second argument is something else than function (still optional): #138.{
title: void 0, // String. Required
message: void 0, // String. Required if remove is not defined
icon: void 0, // String. Absolute path to Icon
sound: false, // Bool | String (as defined by http://msdn.microsoft.com/en-us/library/windows/apps/hh761492.aspx)
wait: false, // Bool. Wait for User Action against Notification or times out
id: void 0, // Number. ID to use for closing notification.
appID: void 0, // String. App.ID. Don't create a shortcut but use the provided app id.
remove: void 0, // Number. Refer to previously created notification to close.
install: void 0 // String (path, application, app id). Creates a shortcut <path> in the start menu which point to the executable <application>, appID used for the notifications.
}
Internal changes for those who might be interested.
lodash.deepClone). Now uses JSON serialize/deserialize instead.prettier.DEBUG env-var to true. See CONTRIBUTE.md for more details.Adds npm ignore file, ignoring tests and examples from package.
Adds support for Icon URL in Growl (by @gucong3000)
notify callback (by @MadLittleMods)file:///xxx protocol icon paths for Windows 8.1 (by @gucong3000)Adds syntactic sugar for notify. Now able to just pass message:
notify. Now able to just pass message:notifier.notify('My message');
See #45 for more info.
semver dependency to support Webpacking with Electron.Changes to exec terminal-notifier through execFile to allow for asar-packages
Adds new stdin CLI options to docs
Obligatory patch fix:
Adds support for piping messages in to CLI. (With node-notifier installed as a CLI npm i -g node-notifier)
node-notifier installed as a CLI npm i -g node-notifier)➜ echo "Message" | notify
➜ echo "Message" | notify -t "My Title"
➜ echo "Some message" | notify -t "My Title" -s
Fixed input arguments to CLI to be strings where they should be strings.
Fixed no notification when no message for the CLI. #58
which test to be sync, avoiding some edge cases with multiple notifications.Minor fix for docs in CLI usage
Fixes Debug "HRESULT : 0xC00CE508" exception on Win8. PR #49
Fixes correct terminal-notifier (own fork https://github.com/mikaelbr/terminal-notifier) to support activate / click.
Fixes proper error codes for balloon: #42
Adds support for changing host and port for Growl.
Fixes Notification center issue with multiple callback events.
Fixes issue with immidiate notifu notifications (with wait : false)
wait : false)Fixes issue with optional callback for notify-send
Major changes and breaking API.
Major changes and breaking API.
var notifier = require('node-notifier');
notifier.notify();
wait property (default false), to get user input for
Notification Center, Windows Toaster, Windows Balloons and Growl. Sadly not
for notify-send.var notifier = require('node-notifier');
notifier.notify({ wait: true }, function (err, response) {
// response is response after user have interacted
// with the notification or the notification has timed out.
});
click or timeout. This is only applicable if { wait: true }.var notifier = require('node-notifier');
notifier.on('click', function (notificationObject, options) {
// options.someArbitraryData === 'foo'
});
notifier.notify({ wait: true, someArbitraryData: 'foo' });
{ sound: true }.
Default NotificationCenter sound is Bottle. Can still use define sound on
Mac:var notifier = require('node-notifier');
notifier.notify({ sound: true });
// For mac (same as sound: true on Windows 8)
notifier.notify({ sound: 'Morse' });
Nothing published for this version
Adds Growl as priority over Balloons
Adds support for native Windows 7 and earlier (through task bar balloons)
Fixes support for notifications from folders with spaces on Windows.
1. Adds native Windows 8 support.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fixes typo: Changes Growl app name from Gulp to Node.
Gulp to Node.Fixes expires for notify-send (Issue #13)
Nothing published for this version
Fixes version check for Mac OS X Yosemite
Nothing published for this version
Updates terminal-notifier to version 1.6.0; adding support for appIcon and contentImage
Nothing published for this version
Nothing published for this version
One column per quarter.