Node port of Eloy Durán's terminal-notifier []
Last updated 7 years ago by vivekvasani .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install node-notify 
SYNC missed versions from official npm registry.

Node Notify


npm install node-notify


var notify = require('node-notify');

notify('Hello World');  // Pass only a string

notify({title: "My App", message: "Hello World"});  // Pass object with multiple paramters


message: VALUE [Required]

The message body of the notification.

title: VALUE

The title of the notification. [Default: 'Terminal'].

subtitle: VALUE

The subtitle of the notification.

sound NAME

The name of a sound to play when the notification appears. The names are listed in Sound Preferences. Use 'default' for the default notification sound.

group ID

Specifies the ‘group’ a notification belongs to. For any ‘group’ only one notification will ever be shown, replacing previously posted notifications.

A notification can be explicitely removed with the remove option, describe below.

Examples are:

  • The sender’s name to scope the notifications by tool.
  • The sender’s process ID to scope the notifications by a unique process.
  • The current working directory to scope notifications by project.

-remove ID

Removes a notification that was previously sent with the specified ‘group’ ID, if one exists. If used with the special group "ALL", all message are removed.

list ID

Lists details about the specified ‘group’ ID. If used with the special group "ALL", details about all currently active messages are displayed.

The output of this command is tab-separated, which makes it easy to parse.

activate ID

Specifies which application should be activated when the user clicks the notification.

You can find the bundle identifier of an application in its Info.plist file inside the application bundle.

Examples are:

  • to activate
  • to activate


Simply supply the app name and node-notify will attempt to find the app and its bundle identifier

sender ID

Specifying this will make it appear as if the notification was send by that application instead, including using its icon.

Using this option fakes the sender application, so that the notification system will launch that application when the notification is clicked. Because of this it is important to note that you cannot combine this with options like execute and activate which depend on the sender of the notification to be ‘terminal-notifier’ to perform its work.

For information on the ID see the activate option.

open URL

Specifies a resource to be opened when the user clicks the notification. This can be a web or file URL, or any custom URL scheme.

execute COMMAND

Specifies a shell command to run when the user clicks the notification.

Current Tags

  • 1.0.0                                ...           latest (5 years ago)

3 Versions

  • 1.0.0                                ...           5 years ago
  • 0.0.2                                ...           7 years ago
  • 0.0.1                                ...           7 years ago
Maintainers (1)
Today 0
This Week 0
This Month 0
Last Day 0
Last Week 0
Last Month 1
Dependencies (1)
Dev Dependencies (0)

Copyright 2014 - 2016 © |