@delorenj/claude-notifications 1.1.0 → 1.2.0

package/README.md

@@ -20,8 +20,9 @@ That's it! 🎉 The package will automatically:
 ## Features
 
 - 🎵 **Final Fantasy Dream Harp** - Classic C-D-E-G ascending/(optional)descending pattern
+- 🔔 **Service Desk Bell** - Optional short, crisp bell sound for a quick "done!" signal
 - 🔊 **Cross-Platform Audio** - Works on Linux and macOS
-- 🖥️ **Desktop Notifications** - Visual notifications with Claude Code branding
+- 🖥️ **Desktop Notifications** - Visual notifications with Claude Code branding (optional)
 - 🪝 **Auto-Integration** - Automatically configures Claude Code hooks
 - ⚡ **Zero Configuration** - Works out of the box
 -  webhook **Webhook Support** - Trigger a webhook in addition to or instead of the sound
@@ -37,9 +38,15 @@ After installation, Claude Code will begin notifying you when it finishes or is
 # Trigger notification manually
 claude-notify
 
+# Trigger bell notification manually
+claude-notify --bell
+
 # Test the system
 claude-notifications test
 
+# Test the bell sound
+claude-notifications test-bell
+
 # Reinstall/repair
 claude-notifications install
 
@@ -121,6 +128,8 @@ Create a configuration file at `~/.config/claude-notifications/settings.json`.
 ```json
 {
   "sound": true,
+  "soundType": "claude-notification",
+  "desktopNotification": false,
   "webhook": {
     "enabled": true,
     "url": "https://maker.ifttt.com/trigger/claude_notification/with/key/YOUR_KEY",
@@ -131,7 +140,11 @@ Create a configuration file at `~/.config/claude-notifications/settings.json`.
 
 **Configuration Options:**
 
-- `sound`: (boolean) Whether to play the notification sound. Defaults to `true`.
+- `sound`: (boolean) Whether to play notification sounds. Defaults to `true`.
+- `soundType`: (string) Which sound to play. Available options:
+  - `"claude-notification"` - Final Fantasy dream harp (default)
+  - `"claude-notification-bell"` - Service desk bell
+- `desktopNotification`: (boolean) Whether to show desktop notification banners. Defaults to `false`.
 - `webhook.enabled`: (boolean) Whether to trigger the webhook. Defaults to `false`.
 - `webhook.url`: (string) The URL to send the POST request to.
 - `webhook.replaceSound`: (boolean) If `true`, the sound will not play when a webhook is triggered. Defaults to `false`.
@@ -144,6 +157,10 @@ The webhook will be sent as a `POST` request with a JSON payload:
 }
 ```
 
+### Sound Files
+
+Sound files are stored in `~/.config/claude-notifications/sounds/` and can be customized by replacing the `.wav` files in that directory.
+
 ### Create Custom Patterns
 
 Use `sox` to create new victory fanfares:

package/bin/claude-notifications.js

@@ -4,6 +4,7 @@ const { execSync, spawn } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 const os = require("os");
+const { ensureSoundsDirectory, getSoundPath, SOUND_TYPES, soundsDir } = require("../lib/config");
 
 const colors = {
   red: "\x1b[31m",
@@ -106,13 +107,8 @@ function updateClaudeCodeConfig() {
 }
 
 function createSoundFile() {
-  const soundDir = path.join(os.homedir(), ".local", "share", "sounds");
-  const soundFile = path.join(soundDir, "claude-notification.wav");
-
-  // Create directory if it doesn't exist
-  if (!fs.existsSync(soundDir)) {
-    fs.mkdirSync(soundDir, { recursive: true });
-  }
+  ensureSoundsDirectory();
+  const soundFile = getSoundPath(SOUND_TYPES.HARP);
 
   // Check if sox is available
   try {
@@ -207,6 +203,79 @@ function createSoundFile() {
   }
 }
 
+function generateBellSoxCommand(outputFile) {
+  // Bell sound parameters - adjust these to customize the bell
+  const bellParams = {
+    // Base tone generation
+    duration: 0.1, // Length of the initial bell strike (seconds)
+    frequency: 1600, // Pitch of the bell (Hz) - higher = more "ting", lower = more "dong"
+
+    // Fade envelope
+    fadeIn: 0, // Fade in time (seconds) - 0 for immediate attack
+    fadeDuration: 0.1, // Total fade duration (seconds)
+    fadeOut: 0.05, // Fade out time (seconds) - creates the bell decay
+
+    // Volume
+    volume: 0.9, // Master volume (0.0 to 1.0)
+
+    // Echo effect parameters (creates the "ringing" quality)
+    echoGain: 0.5, // Overall echo volume (0.0 to 1.0)
+    echoDecay: 0.5, // How quickly echoes fade (0.0 to 1.0)
+
+    // Individual echo delays and volumes (milliseconds, volume)
+    echo1: { delay: 250, volume: 0.2 }, // First echo - quarter second delay
+    echo2: { delay: 500, volume: 0.05 }, // Second echo - half second delay
+    echo3: { delay: 750, volume: 0.01 }, // Third echo - three quarter second delay
+
+    // Reverb parameters (adds spatial depth)
+    reverb: {
+      roomSize: 40, // Room size percentage (0-100) - larger = more spacious
+      preDelay: 65, // Pre-delay in ms - time before reverb starts
+      reverbTime: 100, // Reverb decay time percentage (0-100)
+      wetGain: 100, // Wet signal gain percentage (0-100) - reverb volume
+      dryGain: 12, // Dry signal gain percentage (0-100) - original signal volume
+      stereoDepth: 0, // Stereo depth (0-100) - 0 = mono, higher = wider stereo
+    },
+  };
+
+  // Build the sox command with clear parameter mapping
+  const command = [
+    "sox -n", // Generate from nothing (null input)
+    `"${outputFile}"`, // Output file
+    `synth ${bellParams.duration} sine ${bellParams.frequency}`, // Generate sine wave
+    `fade ${bellParams.fadeIn} ${bellParams.fadeDuration} ${bellParams.fadeOut}`, // Apply fade envelope
+    `vol ${bellParams.volume}`, // Set volume
+    `echos ${bellParams.echoGain} ${bellParams.echoDecay}`, // Echo effect base settings
+    `${bellParams.echo1.delay} ${bellParams.echo1.volume}`, // Echo 1: 250ms delay, 0.2 volume
+    `${bellParams.echo2.delay} ${bellParams.echo2.volume}`, // Echo 2: 500ms delay, 0.1 volume
+    `${bellParams.echo3.delay} ${bellParams.echo3.volume}`, // Echo 3: 750ms delay, 0.05 volume
+    `reverb ${bellParams.reverb.roomSize} ${bellParams.reverb.preDelay}`, // Reverb room & pre-delay
+    `${bellParams.reverb.reverbTime} ${bellParams.reverb.wetGain}`, // Reverb time & wet gain
+    `${bellParams.reverb.dryGain} ${bellParams.reverb.stereoDepth}`, // Dry gain & stereo depth
+  ].join(" ");
+
+  return command;
+}
+
+function createBellSoundFile() {
+  ensureSoundsDirectory();
+  const soundFile = getSoundPath(SOUND_TYPES.BELL);
+
+  log("blue", "🔔 Generating service desk bell sound...");
+
+  try {
+    // Generate the bell sound using our documented sox command builder
+    const bellCommand = generateBellSoxCommand(soundFile);
+    execSync(bellCommand, { stdio: "ignore", timeout: 5000 });
+
+    log("green", "✅ Bell sound file created successfully!");
+    return true;
+  } catch (error) {
+    log("red", `❌ Error creating bell sound file: ${error.message}`);
+    return false;
+  }
+}
+
 function main() {
   const command = process.argv[2];
 
@@ -215,7 +284,7 @@ function main() {
     case undefined:
       log("blue", "🎵 Installing Claude Notifications...");
 
-      if (createSoundFile()) {
+      if (createSoundFile() && createBellSoundFile()) {
         updateClaudeCodeConfig();
         log("green", "🎉 Installation complete!");
         log("blue", "🧪 Testing notification...");
@@ -256,21 +325,36 @@ function main() {
       });
       break;
 
+    case "test-bell":
+      log("blue", "🔔 Testing bell notification...");
+      spawn("node", [path.join(__dirname, "claude-notify.js"), "--bell"], {
+        stdio: "inherit",
+      });
+      break;
+
     case "uninstall":
       log("blue", "🗑️  Uninstalling Claude Notifications...");
 
-      const soundFile = path.join(
-        os.homedir(),
-        ".local",
-        "share",
-        "sounds",
-        "claude-notification.wav",
-      );
-      if (fs.existsSync(soundFile)) {
-        fs.unlinkSync(soundFile);
-        log("green", "✅ Removed sound file");
+      // Remove sounds directory
+      if (fs.existsSync(soundsDir)) {
+        fs.rmSync(soundsDir, { recursive: true, force: true });
+        log("green", "✅ Removed sounds directory");
       }
 
+      // Also clean up old sound files if they exist
+      const oldSoundDir = path.join(os.homedir(), ".local", "share", "sounds");
+      const oldSoundFiles = [
+        path.join(oldSoundDir, "claude-notification.wav"),
+        path.join(oldSoundDir, "claude-notification-bell.wav")
+      ];
+      
+      oldSoundFiles.forEach(file => {
+        if (fs.existsSync(file)) {
+          fs.unlinkSync(file);
+          log("green", `✅ Removed old sound file: ${path.basename(file)}`);
+        }
+      });
+
       log(
         "yellow",
         "⚠️  Please manually remove the stop hook from your Claude Code config",
@@ -289,6 +373,7 @@ function main() {
       console.log("Commands:");
       console.log("  install    Install notifications (default)");
       console.log("  test       Test the notification");
+      console.log("  test-bell  Test the bell notification");
       console.log("  uninstall  Remove notifications");
       console.log("  help       Show this help");
       break;

package/bin/claude-notify.js

@@ -6,19 +6,31 @@ const path = require('path');
 const os = require('os');
 const http = require('http');
 const https = require('https');
-const { getConfig } = require('../lib/config');
+const { getConfig, getSoundPath, SOUND_TYPES } = require('../lib/config');
 
 const config = getConfig();
 
+// Check for command line arguments
+const args = process.argv.slice(2);
+const useBell = args.includes('--bell') || args.includes('-b');
+const showConfig = args.includes('-c') || args.includes('--config');
+
 function playSound() {
   if (!config.sound) {
     return;
   }
 
-  const soundFile = path.join(os.homedir(), '.local', 'share', 'sounds', 'claude-notification.wav');
+  // Determine which sound to play
+  let soundType = config.soundType;
+  if (useBell) {
+    soundType = SOUND_TYPES.BELL;
+  }
+
+  const soundFile = getSoundPath(soundType);
   
   if (!fs.existsSync(soundFile)) {
-    process.stdout.write('\x07');
+    console.warn(`Sound file not found: ${soundFile}`);
+    process.stdout.write('\x07'); // Fallback to system beep
     return;
   }
 
@@ -97,7 +109,73 @@ function showNotification() {
   });
 }
 
+function showConfigInfo() {
+  const configPath = path.join(os.homedir(), '.config', 'claude-notifications', 'settings.json');
+  const soundsDir = path.join(os.homedir(), '.config', 'claude-notifications', 'sounds');
+  
+  console.log('🔍 Claude Notifications Config Debug Info:');
+  console.log('');
+  console.log('📁 Config file location:');
+  console.log(`   ${configPath}`);
+  console.log(`   Exists: ${fs.existsSync(configPath) ? '✅' : '❌'}`);
+  
+  if (fs.existsSync(configPath)) {
+    try {
+      const configContent = fs.readFileSync(configPath, 'utf-8');
+      console.log('   Content:');
+      console.log(`   ${configContent.split('\n').map(line => `   ${line}`).join('\n')}`);
+    } catch (error) {
+      console.log(`   Error reading: ${error.message}`);
+    }
+  }
+  
+  console.log('');
+  console.log('🔊 Sounds directory:');
+  console.log(`   ${soundsDir}`);
+  console.log(`   Exists: ${fs.existsSync(soundsDir) ? '✅' : '❌'}`);
+  
+  if (fs.existsSync(soundsDir)) {
+    try {
+      const soundFiles = fs.readdirSync(soundsDir);
+      console.log('   Files:');
+      soundFiles.forEach(file => {
+        const filePath = path.join(soundsDir, file);
+        const stats = fs.statSync(filePath);
+        console.log(`   - ${file} (${Math.round(stats.size / 1024)}KB)`);
+      });
+    } catch (error) {
+      console.log(`   Error reading directory: ${error.message}`);
+    }
+  }
+  
+  console.log('');
+  console.log('⚙️  Current config values:');
+  console.log(`   sound: ${config.sound}`);
+  console.log(`   soundType: ${config.soundType}`);
+  console.log(`   desktopNotification: ${config.desktopNotification}`);
+  console.log(`   webhook.enabled: ${config.webhook.enabled}`);
+  
+  console.log('');
+  console.log('🎵 Sound file paths:');
+  const { SOUND_TYPES, getSoundPath } = require('../lib/config');
+  Object.values(SOUND_TYPES).forEach(soundType => {
+    const soundPath = getSoundPath(soundType);
+    console.log(`   ${soundType}: ${soundPath}`);
+    console.log(`   Exists: ${fs.existsSync(soundPath) ? '✅' : '❌'}`);
+  });
+  
+  console.log('');
+  console.log('🔧 Command line args:');
+  console.log(`   useBell: ${useBell}`);
+  console.log(`   showConfig: ${showConfig}`);
+}
+
 function main() {
+  if (showConfig) {
+    showConfigInfo();
+    return;
+  }
+  
   if (config.webhook.enabled) {
     triggerWebhook();
     if (!config.webhook.replaceSound) {
@@ -105,7 +183,9 @@ function main() {
     }
   } else {
     playSound();
-    showNotification();
+    if (config.desktopNotification) {
+      showNotification();
+    }
   }
 }
 

package/lib/config.js

@@ -3,10 +3,19 @@ const path = require('path');
 const os = require('os');
 
 const configPath = path.join(os.homedir(), '.config', 'claude-notifications', 'settings.json');
+const soundsDir = path.join(os.homedir(), '.config', 'claude-notifications', 'sounds');
+
+// Available sound types (filenames without extension)
+const SOUND_TYPES = {
+  HARP: 'claude-notification',
+  BELL: 'claude-notification-bell'
+};
 
 function getConfig() {
   const defaultConfig = {
     sound: true,
+    soundType: SOUND_TYPES.HARP,  // Default to harp sound
+    desktopNotification: false,
     webhook: {
       enabled: false,
       url: null,
@@ -21,6 +30,13 @@ function getConfig() {
   try {
     const configContent = fs.readFileSync(configPath, 'utf-8');
     const userConfig = JSON.parse(configContent);
+    
+    // Handle migration from old 'secondSound' config
+    if (userConfig.secondSound === true && !userConfig.soundType) {
+      userConfig.soundType = SOUND_TYPES.BELL;
+      delete userConfig.secondSound;
+    }
+    
     return { ...defaultConfig, ...userConfig };
   } catch (error) {
     console.error('Error reading or parsing config file:', error);
@@ -28,4 +44,20 @@ function getConfig() {
   }
 }
 
-module.exports = { getConfig };
+function getSoundPath(soundType) {
+  return path.join(soundsDir, `${soundType}.wav`);
+}
+
+function ensureSoundsDirectory() {
+  if (!fs.existsSync(soundsDir)) {
+    fs.mkdirSync(soundsDir, { recursive: true });
+  }
+}
+
+module.exports = { 
+  getConfig, 
+  getSoundPath, 
+  ensureSoundsDirectory,
+  SOUND_TYPES,
+  soundsDir 
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/claude-notifications",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Delightful Notification for Claude Code",
   "main": "index.js",
   "bin": {