nodemon-fahhh 🔥

nodemon-fahhh is a lightweight CLI wrapper around nodemon that plays a sound whenever your Node.js application crashes.

It preserves the full default nodemon behavior — logs, restart messages, and workflow — while adding an audible alert when your server dies.

No extra logs.
No modified behavior.
Just sound on crash.

🚀 Installation

Global Installation (Recommended)

npm install -g nodemon-fahhh

Then run:

nodemon-fahhh server.js

Local (Project) Installation

npm install --save-dev nodemon-fahhh

Add it to your package.json:

{
  "scripts": {
    "dev": "nodemon-fahhh server.js"
  }
}

Run:

npm run dev

▶️ Usage

Basic usage:

nodemon-fahhh <entry-file>

Example:

nodemon-fahhh server.js

It behaves exactly like running:

nodemon server.js

You will see standard nodemon output:

[nodemon] restarting due to changes...
[nodemon] starting `node server.js`
[nodemon] clean exit - waiting for changes before restart

When the app crashes:

[nodemon] app crashed - waiting for file changes before starting...

🔊 A sound is played.

🎵 Custom Sound

You can provide your own audio file:

nodemon-fahhh server.js --sound ./boom.mp3

Supported formats depend on your OS audio capabilities (commonly .mp3 and .wav).

⚙️ How It Works

• Spawns the real nodemon CLI internally
• Listens for the app crashed message
• Plays a sound when detected
• Forwards all output unchanged

This ensures:

• 100% default nodemon behavior
• No interference with your development workflow
• No additional console noise

🌍 Platform Support

Works anywhere nodemon works:

• macOS
• Linux
• Windows

Audio playback uses system-level audio utilities available on each platform.

✅ Features

• Preserves full nodemon output
• Plays sound only when the app crashes
• No extra console logs
• Lightweight
• Zero configuration required
• Supports custom sound files

📦 Versioning

This package follows semantic versioning:

• Patch → bug fixes
• Minor → feature additions
• Major → breaking changes

🤔 Why nodemon-fahhh?

Because silent crashes are easy to miss.

When you're multitasking, debugging, or away from the screen, an audible alert makes sure you immediately know your app went down.

📄 License

MIT