agentvibes 2.4.0 → 2.4.1

package/.claude/hooks/play-tts-piper.sh

@@ -326,8 +326,16 @@ DURATION=${DURATION:-1}   # Default to 1 second if detection fails
 
 # Play audio in background (skip if in test mode)
 if [[ "${AGENTVIBES_TEST_MODE:-false}" != "true" ]]; then
-  (mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
-  PLAYER_PID=$!
+  # Detect platform and use appropriate audio player
+  if [[ "$(uname -s)" == "Darwin" ]]; then
+    # macOS: Use afplay (native macOS audio player)
+    afplay "$TEMP_FILE" >/dev/null 2>&1 &
+    PLAYER_PID=$!
+  else
+    # Linux/WSL: Try mpv, aplay, or paplay
+    (mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
+    PLAYER_PID=$!
+  fi
 fi
 
 # Wait for audio to finish, then release lock

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.4.0
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.4.1
 
 ---
 
@@ -92,15 +92,15 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or using Warp
 
 ## 📰 Latest Release
 
-**[v2.4.0 - macOS Piper TTS Support](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.4.0)** 🎉
+**[v2.4.1 - macOS Audio Playback Fix](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.4.1)** 🎉
 
-This release brings **full Piper TTS support to macOS** via precompiled binaries! Mac users can now enjoy completely free offline TTS with zero Python dependencies. The installer automatically detects your Mac architecture (Intel or Apple Silicon) and downloads the appropriate binary.
+This patch release fixes a critical audio playback issue on macOS where Piper TTS audio files were being created but not playing. The fix adds platform detection to use the native macOS `afplay` audio player.
 
 **Key highlights:**
-- 🍎 **macOS Piper TTS Support** - Install via precompiled binaries (no Python/pipx needed!)
-- 🏗️ **Architecture Auto-Detection** - Supports both Apple Silicon (M1/M2/M3) and Intel Macs
-- 🐛 **Fixed Installation Issues** - Resolved pipx dependency conflicts on macOS
-- ✅ **Comprehensive CI Testing** - Validated across 9 macOS configurations (macOS 13/14/15)
+- 🔊 **Fixed macOS Audio Playback** - Audio now plays correctly using native `afplay` command
+- 🐛 **Critical Bug Fix** - Resolved silent audio playback on macOS after v2.4.0 install
+- 🙏 **Community Contribution** - Thanks to BMadCode for reporting and testing!
+- 🍎 **macOS Support Complete** - Both installation (v2.4.0) and playback (v2.4.1) now working
 
 [→ View All Releases](https://github.com/paulpreibisch/AgentVibes/releases)
 

package/RELEASE_NOTES.md

@@ -1,3 +1,67 @@
+# Release v2.4.1 - macOS Audio Playback Fix (2025-01-15)
+
+## 🤖 AI Summary
+
+This patch release fixes a critical audio playback issue on macOS where Piper TTS audio files were being created but not playing. The fix adds platform detection to use the native macOS `afplay` audio player instead of trying to use Linux-only audio players (mpv/aplay/paplay) that don't exist on macOS.
+
+## 📋 Changes
+
+### 🐛 Bug Fixes
+- **Fixed macOS Audio Playback in Piper TTS**
+  - Added platform detection to use `afplay` on macOS (Darwin)
+  - Keeps existing Linux audio players (mpv/aplay/paplay) for WSL/Linux
+  - Audio files now play correctly on macOS instead of silently failing
+  - File: `.claude/hooks/play-tts-piper.sh` line 329-339
+
+## 🎯 User Impact
+
+**For macOS Users**: Audio playback now works! If you were seeing "🎵 Saved to:" messages but hearing no sound, this update fixes that. Simply run `npx agentvibes@latest install --yes` to get the fix.
+
+**What Was Broken**: After v2.4.0 added macOS Piper TTS support, audio files were being generated successfully but the playback failed silently because the script was trying to use Linux audio players that don't exist on macOS.
+
+**What's Fixed**: The script now detects macOS and uses the native `afplay` command for audio playback.
+
+## 📦 Files Changed
+
+### Modified
+- `.claude/hooks/play-tts-piper.sh` - Added macOS platform detection for audio playback
+
+### Statistics
+- 1 file changed
+- 10 insertions(+)
+- 2 deletions(-)
+
+## 🔄 Breaking Changes
+
+None. This is a pure bug fix release.
+
+## 🚀 Upgrade Notes
+
+Simply run:
+```bash
+npx agentvibes@latest install --yes
+```
+
+This will update the hooks with the fixed audio playback script.
+
+## 🙏 Credits
+
+Special thanks to:
+- **BMadCode** for reporting the issue and testing on macOS! (Official AgentVibes contributor 🎉)
+- macOS users who helped identify the silent audio playback problem
+
+## 🔗 Related
+
+- v2.4.0 - Initial macOS Piper TTS support
+- Issue: Audio files created but not playing on macOS
+- Fix: Platform detection for native audio player selection
+
+---
+
+**Full Changelog**: https://github.com/paulpreibisch/AgentVibes/compare/v2.4.0...v2.4.1
+
+---
+
 # Release v2.4.0 - macOS Piper TTS Support (2025-01-15)
 
 ## 🤖 AI Summary

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/installer.js

@@ -112,22 +112,19 @@ function showReleaseInfo() {
   console.log(
     boxen(
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
-      chalk.cyan.bold('  📦 AgentVibes v2.4.0 - macOS Piper TTS Support\n') +
+      chalk.cyan.bold('  📦 AgentVibes v2.4.1 - macOS Audio Playback Fix\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.green.bold('✨ WHAT\'S NEW:\n\n') +
-      chalk.cyan('🍎 macOS Piper TTS Support\n') +
-      chalk.gray('   • Install via precompiled binaries (no Python/pipx needed!)\n') +
-      chalk.gray('   • Architecture auto-detection (Apple Silicon M1/M2/M3 & Intel)\n') +
-      chalk.gray('   • Completely free offline TTS for Mac users\n') +
-      chalk.gray('   • Zero dependency conflicts - just download and run\n\n') +
-      chalk.cyan('🐛 Bug Fixes\n') +
-      chalk.gray('   • Fixed macOS Piper installation failures\n') +
-      chalk.gray('   • Resolved pipx dependency conflicts on macOS\n') +
-      chalk.gray('   • Removed incorrect platform restrictions\n\n') +
-      chalk.cyan('✅ Comprehensive Testing\n') +
-      chalk.gray('   • CI tests across 9 macOS configurations\n') +
-      chalk.gray('   • Validated on macOS 13, 14, and 15\n') +
-      chalk.gray('   • Tested on both Intel and Apple Silicon\n\n') +
+      chalk.green.bold('🔊 CRITICAL FIX:\n\n') +
+      chalk.cyan('Fixed macOS Audio Playback\n') +
+      chalk.gray('   • Audio now plays correctly on macOS using native afplay\n') +
+      chalk.gray('   • Resolved silent audio playback issue from v2.4.0\n') +
+      chalk.gray('   • Platform detection for Linux/WSL vs macOS audio players\n') +
+      chalk.gray('   • Thanks to BMadCode for reporting! 🙏\n\n') +
+      chalk.cyan('🍎 macOS Support Complete (v2.4.0 + v2.4.1)\n') +
+      chalk.gray('   • Install via precompiled binaries (no Python/pipx!)\n') +
+      chalk.gray('   • Architecture auto-detection (Apple Silicon & Intel)\n') +
+      chalk.gray('   • Audio playback now working perfectly\n') +
+      chalk.gray('   • Completely free offline TTS for Mac users\n\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
       chalk.green.bold('🚀 TRY LANGUAGE LEARNING MODE:\n\n') +
       chalk.cyan('  /agent-vibes:language english\n') +