# mikaelbr/node-notifier

A Node.js module for sending notifications on native Mac, Windows and Linux (or Growl as fallback)

Repository: https://github.com/mikaelbr/node-notifier
Canonical: https://ross.abutalabs.com/products/node-notifier
Language: JavaScript
License: MIT
License Family: permissive
Topics: javascript, notification-center, growl, node-notifier, notification, toasters, nodejs, hacktoberfest
Last push: 2024-06-24T13:43:42+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5022, "days_push": 800, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5845, forks 319 (observed 2026-08-28T04:09:31.574622+00:00)

## What it is
A Node.js library for sending native desktop notifications across macOS, Windows, and Linux, with Growl as a fallback. It supports notification actions, sounds, icons, and click/timeout events.

## Use cases
- show desktop notifications from a node script
- send native notifications cross-platform in nodejs
- notify user when a long task finishes
- add toast notifications to an electron app
- display notification center alerts from javascript

## When to choose
- you need native OS notifications from Node.js on multiple platforms
- you want a simple API with fallbacks like Growl
- you need notification click/timeout event handling

## When to avoid
- you need web/browser push notifications
- you want a CLI tool (use node-notifier-cli instead)
- your app runs only on mobile

## Facets
- artifact type: library
- maturity: stable
- function: gui, developer-tools
- domain: cross-platform, desktop-applications, developer-tools
- platform: windows, cross-platform
- tags: notifications, notification-center, growl, toasts, desktop-notifications, nodejs, macos, linux

## Member repositories
- mikaelbr/node-notifier (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:31.574622+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:51:54.751365+00:00, confidence not recorded.
  - readme: https://github.com/mikaelbr/node-notifier (fetched 2026-08-28T04:09:31.574622+00:00, sha 9d729686f856)
  - registry_npm: https://registry.npmjs.org/node-notifier (fetched 2026-08-29T08:47:34.166237+00:00, sha 4fc13b551706)
- Data as of 2026-08-30T08:39:29.467469+00:00.