agentvibes 2.0.20 → 2.0.22

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

@@ -75,8 +75,18 @@ else
 
   if [[ -n "$VOICE_FILE" ]]; then
     FILE_VOICE=$(cat "$VOICE_FILE" 2>/dev/null)
-    # Check if it's a Piper model name (contains underscore and dash, or speaker ID with #)
-    if [[ "$FILE_VOICE" == *"_"*"-"* ]] || [[ "$FILE_VOICE" == *"#"* ]]; then
+
+    # Check for multi-speaker voice (model + speaker ID stored separately)
+    MODEL_FILE="$SCRIPT_DIR/../tts-piper-model.txt"
+    SPEAKER_ID_FILE="$SCRIPT_DIR/../tts-piper-speaker-id.txt"
+
+    if [[ -f "$MODEL_FILE" ]] && [[ -f "$SPEAKER_ID_FILE" ]]; then
+      # Multi-speaker voice
+      VOICE_MODEL=$(cat "$MODEL_FILE" 2>/dev/null)
+      SPEAKER_ID=$(cat "$SPEAKER_ID_FILE" 2>/dev/null)
+      echo "🎭 Using multi-speaker voice: $FILE_VOICE (Model: $VOICE_MODEL, Speaker ID: $SPEAKER_ID)"
+    # Check if it's a standard Piper model name or custom voice (just use as-is)
+    elif [[ -n "$FILE_VOICE" ]]; then
       VOICE_MODEL="$FILE_VOICE"
     fi
   fi
@@ -118,21 +128,7 @@ fi
 # @param Uses global: $VOICE_MODEL
 # @sideeffects Downloads voice model files
 # @edgecases Prompts user for consent before downloading
-
-# Strip speaker ID for verification/download (speaker ID is after #)
-VOICE_MODEL_BASE="$VOICE_MODEL"
-if [[ "$VOICE_MODEL" == *"#"* ]]; then
-  VOICE_MODEL_BASE="${VOICE_MODEL%%#*}"
-fi
-
-# Check if custom voice exists (bypass verification for custom voices)
-CUSTOM_VOICE_PATH="$HOME/.local/share/piper/voices/$VOICE_MODEL_BASE.onnx"
-IS_CUSTOM_VOICE=false
-if [[ -f "$CUSTOM_VOICE_PATH" ]]; then
-  IS_CUSTOM_VOICE=true
-fi
-
-if [[ "$IS_CUSTOM_VOICE" == "false" ]] && ! verify_voice "$VOICE_MODEL_BASE"; then
+if ! verify_voice "$VOICE_MODEL"; then
   echo "📥 Voice model not found: $VOICE_MODEL"
   echo "   File size: ~25MB"
   echo "   Preview: https://huggingface.co/rhasspy/piper-voices"
@@ -141,7 +137,7 @@ if [[ "$IS_CUSTOM_VOICE" == "false" ]] && ! verify_voice "$VOICE_MODEL_BASE"; th
   echo
 
   if [[ $REPLY =~ ^[Yy]$ ]]; then
-    if ! download_voice "$VOICE_MODEL_BASE"; then
+    if ! download_voice "$VOICE_MODEL"; then
       echo "❌ Failed to download voice model"
       echo "Fix: Download manually or choose different voice"
       exit 3
@@ -152,19 +148,11 @@ if [[ "$IS_CUSTOM_VOICE" == "false" ]] && ! verify_voice "$VOICE_MODEL_BASE"; th
   fi
 fi
 
-# Get voice model path (use base model without speaker ID)
-# Suppress stderr from get_voice_path since we have custom voice fallback
-VOICE_PATH=$(get_voice_path "$VOICE_MODEL_BASE" 2>/dev/null)
+# Get voice model path
+VOICE_PATH=$(get_voice_path "$VOICE_MODEL")
 if [[ $? -ne 0 ]]; then
-  # Try custom voice in piper voices directory
-  CUSTOM_PATH="$HOME/.local/share/piper/voices/$VOICE_MODEL_BASE.onnx"
-  if [[ -f "$CUSTOM_PATH" ]]; then
-    VOICE_PATH="$CUSTOM_PATH"
-    echo "🎤 Using custom voice: $VOICE_MODEL_BASE"
-  else
-    echo "❌ Voice model path not found: $VOICE_MODEL"
-    exit 3
-  fi
+  echo "❌ Voice model path not found: $VOICE_MODEL"
+  exit 3
 fi
 
 # @function determine_audio_directory
@@ -254,23 +242,16 @@ SPEECH_RATE=$(get_speech_rate)
 # @function synthesize_with_piper
 # @intent Generate speech using Piper TTS
 # @why Provides free, offline TTS alternative
-# @param Uses globals: $TEXT, $VOICE_PATH, $SPEECH_RATE, $VOICE_MODEL
+# @param Uses globals: $TEXT, $VOICE_PATH, $SPEECH_RATE, $SPEAKER_ID (optional)
 # @returns Creates WAV file at $TEMP_FILE
 # @exitcode 0=success, 4=synthesis error
 # @sideeffects Creates audio file
-# @edgecases Handles piper errors, invalid models, speaker IDs
-
-# Check if voice model includes speaker ID (format: modelname#speakerID)
-SPEAKER_ID=""
-if [[ "$VOICE_MODEL" == *"#"* ]]; then
-  SPEAKER_ID="${VOICE_MODEL##*#}"
-  VOICE_MODEL="${VOICE_MODEL%%#*}"
-fi
-
-# Build piper command with optional speaker parameter
+# @edgecases Handles piper errors, invalid models, multi-speaker voices
 if [[ -n "$SPEAKER_ID" ]]; then
+  # Multi-speaker voice: Pass speaker ID
   echo "$TEXT" | piper --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
 else
+  # Single-speaker voice
   echo "$TEXT" | piper --model "$VOICE_PATH" --length-scale "$SPEECH_RATE" --output_file "$TEMP_FILE" 2>/dev/null
 fi
 
@@ -330,9 +311,11 @@ DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wr
 DURATION=${DURATION%.*}  # Round to integer
 DURATION=${DURATION:-1}   # Default to 1 second if detection fails
 
-# Play audio in background
-(mpv "$TEMP_FILE" || aplay "$TEMP_FILE" || paplay "$TEMP_FILE") >/dev/null 2>&1 &
-PLAYER_PID=$!
+# 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=$!
+fi
 
 # Wait for audio to finish, then release lock
 (sleep $DURATION; rm -f "$LOCK_FILE") &

package/.claude/hooks/provider-manager.sh

@@ -141,12 +141,31 @@ set_active_provider() {
     voice_file="$HOME/.claude/tts-voice.txt"
   fi
 
-  # Remove voice file to force default voice for new provider
-  if [[ -f "$voice_file" ]]; then
-    rm -f "$voice_file"
-  fi
+  # Set default voice for the new provider
+  local default_voice
+  case "$provider" in
+    piper)
+      # Default Piper voice
+      default_voice="en_US-lessac-medium"
+      ;;
+    elevenlabs)
+      # Default ElevenLabs voice (first in alphabetical order from voices-config.sh)
+      default_voice="Amy"
+      ;;
+    *)
+      # Unknown provider - remove voice file
+      if [[ -f "$voice_file" ]]; then
+        rm -f "$voice_file"
+      fi
+      echo "✓ Active provider set to: $provider (voice reset)"
+      return 0
+      ;;
+  esac
+
+  # Write default voice to file
+  echo "$default_voice" > "$voice_file"
 
-  echo "✓ Active provider set to: $provider (voice reset to default)"
+  echo "✓ Active provider set to: $provider (voice set to: $default_voice)"
 }
 
 # @function list_providers

package/.claude/hooks/speed-manager.sh

@@ -191,20 +191,18 @@ set_speed() {
   echo ""
   echo "Note: Speed control works with both Piper and ElevenLabs providers"
 
-  # Array of tongue twisters to demonstrate speed
-  local tongue_twisters=(
-    "Peter Piper picked a peck of pickled peppers"
-    "She sells seashells by the seashore"
-    "How much wood would a woodchuck chuck if a woodchuck could chuck wood"
-    "Fuzzy Wuzzy was a bear, Fuzzy Wuzzy had no hair"
-    "I scream, you scream, we all scream for ice cream"
-    "Red lorry, yellow lorry, red lorry, yellow lorry"
-    "Six slippery snails slid slowly seaward"
+  # Array of simple test messages to demonstrate speed
+  local test_messages=(
+    "Testing speed change"
+    "Speed test in progress"
+    "Checking audio speed"
+    "Speed configuration test"
+    "Audio speed test"
   )
 
-  # Pick a random tongue twister
-  local random_index=$((RANDOM % ${#tongue_twisters[@]}))
-  local test_msg="${tongue_twisters[$random_index]}"
+  # Pick a random test message
+  local random_index=$((RANDOM % ${#test_messages[@]}))
+  local test_msg="${test_messages[$random_index]}"
 
   echo ""
   echo "🔊 Testing new speed with: \"$test_msg\""

package/.claude/hooks/voice-manager.sh

@@ -87,64 +87,17 @@ case "$1" in
         source "$SCRIPT_DIR/piper-voice-manager.sh"
         VOICE_DIR=$(get_voice_storage_dir)
         VOICE_COUNT=0
-
-        # Extract base voice name and speaker ID from current voice if it has # format
-        CURRENT_BASE_VOICE="$CURRENT_VOICE"
-        CURRENT_SPEAKER_ID=""
-        if [[ "$CURRENT_VOICE" == *"#"* ]]; then
-          CURRENT_BASE_VOICE="${CURRENT_VOICE%%#*}"
-          CURRENT_SPEAKER_ID="${CURRENT_VOICE##*#}"
-        fi
-
         for onnx_file in "$VOICE_DIR"/*.onnx; do
           if [[ -f "$onnx_file" ]]; then
             voice=$(basename "$onnx_file" .onnx)
-            json_file="${onnx_file}.json"
-
-            # Check if this is a multi-speaker voice
-            if [[ -f "$json_file" ]] && command -v jq &> /dev/null; then
-              NUM_SPEAKERS=$(jq -r '.num_speakers // 1' "$json_file" 2>/dev/null)
-
-              if [[ "$NUM_SPEAKERS" -gt 1 ]]; then
-                # Multi-speaker voice - list all speakers
-                echo ""
-                echo "  📢 $voice (Multi-speaker: $NUM_SPEAKERS voices)"
-
-                # Read speaker names from JSON
-                jq -r '.speaker_id_map | to_entries[] | "    \(.value)️. \(.key) → \(.value|tostring)#\(.value)"' "$json_file" 2>/dev/null | while read -r speaker_line; do
-                  # Extract speaker ID from the line
-                  speaker_id=$(echo "$speaker_line" | sed -E 's/.*→ ([0-9]+)#[0-9]+$/\1/')
-
-                  # Check if this speaker is current
-                  if [[ "$voice" == "$CURRENT_BASE_VOICE" ]] && [[ "$speaker_id" == "$CURRENT_SPEAKER_ID" ]]; then
-                    # Remove the → ID#ID suffix and add current marker
-                    speaker_display=$(echo "$speaker_line" | sed -E 's/ → [0-9]+#[0-9]+$//')
-                    echo "  ▶ $speaker_display (current)"
-                  else
-                    # Remove the → ID#ID suffix
-                    speaker_display=$(echo "$speaker_line" | sed -E 's/ → [0-9]+#[0-9]+$//')
-                    echo "  $speaker_display"
-                  fi
-                done
-              else
-                # Single-speaker voice
-                if [ "$voice" = "$CURRENT_VOICE" ] || [ "$voice" = "$CURRENT_BASE_VOICE" ]; then
-                  echo "  ▶ $voice (current)"
-                else
-                  echo "    $voice"
-                fi
-              fi
+            if [ "$voice" = "$CURRENT_VOICE" ]; then
+              echo "  ▶ $voice (current)"
             else
-              # No JSON file or jq not available - show as single voice
-              if [ "$voice" = "$CURRENT_VOICE" ] || [ "$voice" = "$CURRENT_BASE_VOICE" ]; then
-                echo "  ▶ $voice (current)"
-              else
-                echo "    $voice"
-              fi
+              echo "    $voice"
             fi
             ((VOICE_COUNT++))
           fi
-        done
+        done | sort
 
         if [[ $VOICE_COUNT -eq 0 ]]; then
           echo "  (No Piper voices downloaded yet)"
@@ -309,11 +262,96 @@ case "$1" in
       ACTIVE_PROVIDER=$(cat "$PROVIDER_FILE")
     fi
 
-    # If using Piper and voice name looks like a Piper model (contains underscore and dash)
-    # then skip ElevenLabs voice validation
-    if [[ "$ACTIVE_PROVIDER" == "piper" ]] && [[ "$VOICE_NAME" == *"_"*"-"* ]]; then
-      # This is a Piper model name, use it directly
-      FOUND="$VOICE_NAME"
+    # Voice lookup strategy depends on active provider
+    if [[ "$ACTIVE_PROVIDER" == "piper" ]]; then
+      # Piper voice lookup: Scan voice directory for .onnx files
+      source "$SCRIPT_DIR/piper-voice-manager.sh"
+      VOICE_DIR=$(get_voice_storage_dir)
+
+      # Check if voice file exists (case-insensitive)
+      FOUND=""
+      shopt -s nullglob
+      for onnx_file in "$VOICE_DIR"/*.onnx; do
+        if [[ -f "$onnx_file" ]]; then
+          voice=$(basename "$onnx_file" .onnx)
+          if [[ "${voice,,}" == "${VOICE_NAME,,}" ]]; then
+            FOUND="$voice"
+            break
+          fi
+        fi
+      done
+      shopt -u nullglob
+
+      # If not found, check multi-speaker registry
+      if [[ -z "$FOUND" ]] && [[ -f "$SCRIPT_DIR/piper-multispeaker-registry.sh" ]]; then
+        source "$SCRIPT_DIR/piper-multispeaker-registry.sh"
+
+        MULTISPEAKER_INFO=$(get_multispeaker_info "$VOICE_NAME")
+        if [[ -n "$MULTISPEAKER_INFO" ]]; then
+          MODEL="${MULTISPEAKER_INFO%%:*}"
+          SPEAKER_ID="${MULTISPEAKER_INFO#*:}"
+
+          # Verify the model file exists
+          if [[ -f "$VOICE_DIR/${MODEL}.onnx" ]]; then
+            # Store speaker name in tts-voice.txt
+            echo "$VOICE_NAME" > "$VOICE_FILE"
+
+            # Store model and speaker ID separately for play-tts-piper.sh
+            echo "$MODEL" > "$CLAUDE_DIR/tts-piper-model.txt"
+            echo "$SPEAKER_ID" > "$CLAUDE_DIR/tts-piper-speaker-id.txt"
+
+            DESCRIPTION=$(get_multispeaker_description "$VOICE_NAME")
+            echo "✅ Multi-speaker voice switched to: $VOICE_NAME"
+            echo "🎤 Model: $MODEL.onnx (Speaker ID: $SPEAKER_ID)"
+            if [[ -n "$DESCRIPTION" ]]; then
+              echo "📝 Description: $DESCRIPTION"
+            fi
+
+            # Have the new voice introduce itself (unless silent mode)
+            if [[ "$SILENT_MODE" != "true" ]]; then
+              PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
+              if [ -x "$PLAY_TTS" ]; then
+                "$PLAY_TTS" "Hi, I'm $VOICE_NAME. I'll be your voice assistant moving forward." > /dev/null 2>&1 &
+              fi
+
+              echo ""
+              echo "💡 Tip: To hear automatic TTS narration, enable the Agent Vibes output style:"
+              echo "   /output-style Agent Vibes"
+            fi
+            exit 0
+          else
+            echo "❌ Multi-speaker model not found: $MODEL.onnx"
+            echo ""
+            echo "Download it with: /agent-vibes:provider download"
+            exit 1
+          fi
+        fi
+      fi
+
+      if [[ -z "$FOUND" ]]; then
+        echo "❌ Piper voice not found: $VOICE_NAME"
+        echo ""
+        echo "Available Piper voices:"
+        shopt -s nullglob
+        for onnx_file in "$VOICE_DIR"/*.onnx; do
+          if [[ -f "$onnx_file" ]]; then
+            echo "  - $(basename "$onnx_file" .onnx)"
+          fi
+        done | sort
+        shopt -u nullglob
+        echo ""
+        if [[ -f "$SCRIPT_DIR/piper-multispeaker-registry.sh" ]]; then
+          echo "Multi-speaker voices (requires 16Speakers.onnx):"
+          source "$SCRIPT_DIR/piper-multispeaker-registry.sh"
+          for entry in "${MULTISPEAKER_VOICES[@]}"; do
+            name="${entry%%:*}"
+            echo "  - $name"
+          done | sort
+          echo ""
+        fi
+        echo "Download extra voices with: /agent-vibes:provider download"
+        exit 1
+      fi
     else
       # ElevenLabs voice lookup
       # Check if input is a number

package/README.md

@@ -311,8 +311,6 @@ AgentVibes supports **custom personalities**, **custom voices**, and **integrati
 - 🗣️ **[OpenWhisper (Azure)](https://learn.microsoft.com/en-us/azure/ai-services/speech-service/whisper-overview)** - Microsoft's speech-to-text service
 - 🎙️ **[ElevenLabs](https://elevenlabs.io/)** - Premium AI voice synthesis
 - 🆓 **[Piper TTS](https://github.com/rhasspy/piper)** - Free offline neural TTS
-- 🎨 **[Custom Piper Voices by Bryce Beattie](https://brycebeattie.com/files/tts/)** - High-quality community Piper voices (Kristin, Jenny)
-- 🛠️ **[Create Custom Piper TTS Voice](https://ssamjh.nz/create-custom-piper-tts-voice/)** - Tutorial for training your own Piper voices
 - 🤖 **[Claude Code](https://claude.com/claude-code)** - AI coding assistant
 - 🎭 **[BMAD METHOD](https://github.com/bmad-code-org/BMAD-METHOD)** - Multi-agent framework
 
@@ -420,7 +418,6 @@ npm update -g agentvibes && agentvibes update --yes
 **Special Thanks:**
 - 💡 [Claude Code Hooks Mastery](https://github.com/disler/claude-code-hooks-mastery) by [@disler](https://github.com/disler) - Hooks inspiration
 - 🤖 [BMAD METHOD](https://github.com/bmad-code-org/BMAD-METHOD) - Multi-agent framework with auto voice switching integration
-- 🎨 [Bryce Beattie](https://brycebeattie.com/files/tts/) - Custom high-quality Piper voices (Kristin, Jenny)
 
 [↑ Back to top](#-table-of-contents)