Add browser audio notifications to Moltbot/Clawdbot webchat with 5 intensity levels - from whisper to impossible-to-miss (only when tab is backgrounded).
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Browser audio notifications for Moltbot/Clawdbot webchat. Plays a notification sound when new messages arrive - but only when the tab is in the background.
cd examples python3 -m http.server 8080 # Open http://localhost:8080/test.html
Test steps:
// Initialize const notifier = new WebchatNotifications({ soundPath: './sounds', soundName: 'level3', // Medium intensity (default) defaultVolume: 0.7 });await notifier.init();
// Trigger on new message socket.on('message', () => notifier.notify());
// Use different levels for different events socket.on('mention', () => { notifier.setSound('level5'); // Loudest for mentions notifier.notify(); });
new WebchatNotifications({ soundPath: './sounds', // Path to sounds directory soundName: 'level3', // level1 (whisper) to level5 (very loud) defaultVolume: 0.7, // 0.0 to 1.0 cooldownMs: 3000, // Min time between alerts enableButton: true, // Show enable prompt debug: false // Console logging });
Intensity Levels:
level1level2level3level4level5init()notify(eventType?)test()setEnabled(bool)setVolume(0-1)setSound(level)getSettings()| Browser | Version | Support |
|---|---|---|
| Chrome | 92+ | โ Full |
| Firefox | 90+ | โ Full |
| Safari | 15+ | โ Full |
| Mobile | Latest | โ ๏ธ Limited |
Overall: 92% of users (Web Audio API support)
webchat-audio-notifications/ โโโ client/ โ โโโ notification.js # Main class (10KB) โ โโโ howler.min.js # Audio library (36KB) โ โโโ sounds/ โ โโโ level1.mp3 # Whisper (9.5KB) โ โโโ level2.mp3 # Soft (12KB) โ โโโ level3.mp3 # Medium (13KB, default) โ โโโ level4.mp3 # Loud (43KB) โ โโโ level5.mp3 # Very Loud (63KB) โโโ examples/ โ โโโ test.html # Standalone test with all levels โโโ docs/ โ โโโ integration.md # Integration guide โโโ README.md # Full documentation
See
docs/integration.mdconst notifier = new WebchatNotifications(); await notifier.init(); notifier.notify();
const notifier = new WebchatNotifications({ soundPath: '/assets/sounds', soundName: 'level2', // Start with soft defaultVolume: 0.8, cooldownMs: 5000, debug: true });await notifier.init();
// Regular messages = soft socket.on('message', () => { notifier.setSound('level2'); notifier.notify(); });
// Mentions = very loud socket.on('mention', () => { notifier.setSound('level5'); notifier.notify(); });
// DMs = loud socket.on('dm', () => { notifier.setSound('level4'); notifier.notify(); });
<input type="range" min="0" max="100" onchange="notifier.setVolume(this.value / 100)"> <button onclick="notifier.test()">Test ๐</button>
No sound?
Sound plays when tab active?
Mobile not working?
MIT License
examples/test.htmlStatus: โ
v1.1.0 Complete - 5 Intensity Levels
Tested: Chrome, Firefox, Safari
Ready for: Production use & ClawdHub publishing
No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
ยฉ 2026 Torly.ai. All rights reserved.