mikaelbr/node-notifier
Node Notifier
node-notifier is a Node.js library and cross-platform wrapper that provides a unified JavaScript interface for sending native desktop notifications on macOS, Windows, and Linux. It acts as a bridge between JavaScript code and system-level notification binaries such as libnotify, Growl, and Windows Toasters.
The project supports integrating native alerts into Node.js applications, Electron desktop apps, and shell scripts. It includes a command-line utility to trigger desktop alerts directly from a terminal using arguments or piped input.
The library manages native alert delivery, including the playback of custom notification audio. It also monitors user interaction, allowing applications to listen for clicks or timeouts to trigger programmatic responses. Configuration options are available to adjust operating system reporter settings, such as application identifiers and urgency levels.
Features
- Cross-Platform Desktop Notifications - Provides a unified JavaScript interface for sending native desktop notifications on macOS, Windows, and Linux.
- Native Module Bridges - Acts as a bridge between JavaScript code and system-level notification binaries like libnotify, Growl, and Windows Toasters.
- Notification Command Line Tools - Provides a command-line utility to trigger desktop alerts using arguments or piped input.
- Native Alert Delivery - Sends native operating system alerts by automatically selecting the most compatible reporting tool for the current environment.
- Cross-Platform Command Wrappers - Translates high-level JavaScript calls into low-level shell commands tailored for macOS, Windows, and Linux.
- System Binary Execution - Triggers notifications by executing pre-installed system binaries or scripts via child processes.
- Node.js Desktop Integration - Interacts with low-level operating system notification services to provide real-time feedback to a local user via Node.js.
- Notification Libraries - Ships a library for sending native cross-platform desktop notifications from Node.js applications.
- Cross-Platform Wrapper Interfaces - Provides a unified interface that abstracts different operating system notification systems into a single consistent API.
- Notification Integrations - Integrates native desktop alerts into Electron applications to notify users of background events or system updates.
- Command Line Notification Tools - Triggering desktop popups directly from a terminal or shell script to notify a developer of task completion.
- Dynamic Provider Switching - Implements runtime selection between different notification provider implementations based on the detected operating system.
- Notification Tooling - Provides a utility for triggering native system alerts and monitoring user interactions within Electron desktop applications.
- Notification Command Mappings - Provides an internal API to map generic notification properties to OS-specific command-line flags.
- Process Output Monitoring - Tracks the exit codes and output of spawned shell processes to detect user interaction and timeouts.
- Notification Monitoring - Listens for user actions like clicks or timeouts to trigger specific programmatic responses when alerts are accessed.
- Notification Interaction Handling - Provides functionality to wait for a user to click an alert or for a timeout to occur to execute a callback.
- Desktop UI - Cross-platform desktop notifications.
- Node.js Frameworks and Tools - Native system notifications for Node.js.
