abstractvoice 0.5.0__tar.gz → 0.5.1__tar.gz

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.5.0
+Version: 0.5.1
 Summary: A modular Python library for voice interactions with AI systems
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -615,6 +615,37 @@ manager.set_tts_model("tts_models/en/ljspeech/glow-tts")
 # - "tts_models/en/ljspeech/glow-tts" (alternative fallback)
 # - "tts_models/en/ljspeech/tacotron2-DDC" (legacy)
 
+# === Audio Lifecycle Callbacks (v0.5.1+) ===
+
+# NEW: Precise audio timing callbacks for visual status indicators
+def on_synthesis_start():
+    print("🔴 Synthesis started - show thinking animation")
+
+def on_audio_start():
+    print("🔵 Audio started - show speaking animation")
+
+def on_audio_pause():
+    print("⏸️ Audio paused - show paused animation")
+
+def on_audio_resume():
+    print("▶️ Audio resumed - continue speaking animation")
+
+def on_audio_end():
+    print("🟢 Audio ended - show ready animation")
+
+def on_synthesis_end():
+    print("✅ Synthesis complete")
+
+# Wire up callbacks
+manager.tts_engine.on_playback_start = on_synthesis_start    # Existing (synthesis phase)
+manager.tts_engine.on_playback_end = on_synthesis_end        # Existing (synthesis phase)
+manager.on_audio_start = on_audio_start                      # NEW (actual audio playback)
+manager.on_audio_end = on_audio_end                          # NEW (actual audio playback)
+manager.on_audio_pause = on_audio_pause                      # NEW (pause events)
+manager.on_audio_resume = on_audio_resume                    # NEW (resume events)
+
+# Perfect for system tray icons, UI animations, or coordinating multiple audio streams
+
 # === STT (Speech-to-Text) ===
 
 def on_transcription(text):

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/README.md

@@ -525,6 +525,37 @@ manager.set_tts_model("tts_models/en/ljspeech/glow-tts")
 # - "tts_models/en/ljspeech/glow-tts" (alternative fallback)
 # - "tts_models/en/ljspeech/tacotron2-DDC" (legacy)
 
+# === Audio Lifecycle Callbacks (v0.5.1+) ===
+
+# NEW: Precise audio timing callbacks for visual status indicators
+def on_synthesis_start():
+    print("🔴 Synthesis started - show thinking animation")
+
+def on_audio_start():
+    print("🔵 Audio started - show speaking animation")
+
+def on_audio_pause():
+    print("⏸️ Audio paused - show paused animation")
+
+def on_audio_resume():
+    print("▶️ Audio resumed - continue speaking animation")
+
+def on_audio_end():
+    print("🟢 Audio ended - show ready animation")
+
+def on_synthesis_end():
+    print("✅ Synthesis complete")
+
+# Wire up callbacks
+manager.tts_engine.on_playback_start = on_synthesis_start    # Existing (synthesis phase)
+manager.tts_engine.on_playback_end = on_synthesis_end        # Existing (synthesis phase)
+manager.on_audio_start = on_audio_start                      # NEW (actual audio playback)
+manager.on_audio_end = on_audio_end                          # NEW (actual audio playback)
+manager.on_audio_pause = on_audio_pause                      # NEW (pause events)
+manager.on_audio_resume = on_audio_resume                    # NEW (resume events)
+
+# Perfect for system tray icons, UI animations, or coordinating multiple audio streams
+
 # === STT (Speech-to-Text) ===
 
 def on_transcription(text):

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/abstractvoice/__init__.py

@@ -32,5 +32,5 @@ from .voice_manager import VoiceManager
 # Import simple APIs for third-party applications
 from .simple_model_manager import list_models, download_model, get_status, is_ready
 
-__version__ = "0.5.0"
+__version__ = "0.5.1"
 __all__ = ['VoiceManager', 'list_models', 'download_model', 'get_status', 'is_ready'] 

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/abstractvoice/tts/tts_engine.py

@@ -212,6 +212,13 @@ class NonBlockingAudioPlayer:
         self.current_position = 0
         self.playback_complete_callback = None
         
+        # NEW: Enhanced audio lifecycle callbacks
+        self.on_audio_start = None      # Called when first audio sample plays
+        self.on_audio_end = None        # Called when last audio sample finishes
+        self.on_audio_pause = None      # Called when audio is paused
+        self.on_audio_resume = None     # Called when audio is resumed
+        self._audio_started = False     # Track if we've fired start callback
+        
     def _audio_callback(self, outdata, frames, time, status):
         """Callback function for OutputStream - provides immediate pause/resume."""
         if status and self.debug_mode:
@@ -237,6 +244,12 @@ class NonBlockingAudioPlayer:
                     outdata.fill(0)
                     if self.is_playing:
                         self.is_playing = False
+                        self._audio_started = False  # Reset for next playback
+                        
+                        # Fire audio end callback
+                        if self.on_audio_end:
+                            threading.Thread(target=self.on_audio_end, daemon=True).start()
+                            
                         if self.playback_complete_callback:
                             # Call completion callback in a separate thread to avoid blocking
                             threading.Thread(target=self.playback_complete_callback, daemon=True).start()
@@ -246,6 +259,12 @@ class NonBlockingAudioPlayer:
             remaining = len(self.current_audio) - self.current_position
             frames_to_output = min(frames, remaining)
             
+            # Fire audio start callback on first real audio output
+            if frames_to_output > 0 and not self._audio_started:
+                self._audio_started = True
+                if self.on_audio_start:
+                    threading.Thread(target=self.on_audio_start, daemon=True).start()
+            
             # Output the audio data
             if frames_to_output > 0:
                 # Handle both mono and stereo output
@@ -344,6 +363,11 @@ class NonBlockingAudioPlayer:
                 self.is_paused = True
                 if self.debug_mode:
                     print(" > Audio paused immediately")
+                
+                # Fire audio pause callback
+                if self.on_audio_pause:
+                    threading.Thread(target=self.on_audio_pause, daemon=True).start()
+                
                 return True
         return False
     
@@ -354,6 +378,11 @@ class NonBlockingAudioPlayer:
                 self.is_paused = False
                 if self.debug_mode:
                     print(" > Audio resumed immediately")
+                
+                # Fire audio resume callback
+                if self.on_audio_resume:
+                    threading.Thread(target=self.on_audio_resume, daemon=True).start()
+                
                 return True
         return False
     
@@ -1264,4 +1293,5 @@ class TTSEngine:
         Returns:
             True if TTS is active, False otherwise
         """
-        return self.is_playing 
+        return self.is_playing
+    

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/abstractvoice/voice_manager.py

@@ -241,6 +241,18 @@ class VoiceManager:
         self.tts_engine.on_playback_start = self._on_tts_start
         self.tts_engine.on_playback_end = self._on_tts_end
         
+        # NEW: Enhanced audio lifecycle callbacks (v0.5.1)
+        self.on_audio_start = None      # Called when first audio sample plays
+        self.on_audio_end = None        # Called when last audio sample finishes
+        self.on_audio_pause = None      # Called when audio is paused
+        self.on_audio_resume = None     # Called when audio is resumed
+        
+        # Wire callbacks directly to audio player (skip TTSEngine layer)
+        self.tts_engine.audio_player.on_audio_start = self._on_audio_start
+        self.tts_engine.audio_player.on_audio_end = self._on_audio_end
+        self.tts_engine.audio_player.on_audio_pause = self._on_audio_pause
+        self.tts_engine.audio_player.on_audio_resume = self._on_audio_resume
+        
         # Voice recognizer is initialized on demand
         self.voice_recognizer = None
         self.whisper_model = whisper_model
@@ -1030,4 +1042,24 @@ class VoiceManager:
             self.voice_recognizer.stop()
 
         self.stop_speaking()
-        return True 
+        return True
+    
+    def _on_audio_start(self):
+        """Called when audio actually starts playing."""
+        if self.on_audio_start:
+            self.on_audio_start()
+    
+    def _on_audio_end(self):
+        """Called when audio actually finishes playing."""
+        if self.on_audio_end:
+            self.on_audio_end()
+    
+    def _on_audio_pause(self):
+        """Called when audio is paused."""
+        if self.on_audio_pause:
+            self.on_audio_pause()
+    
+    def _on_audio_resume(self):
+        """Called when audio is resumed."""
+        if self.on_audio_resume:
+            self.on_audio_resume() 

{abstractvoice-0.5.0 → abstractvoice-0.5.1}/abstractvoice.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: abstractvoice
-Version: 0.5.0
+Version: 0.5.1
 Summary: A modular Python library for voice interactions with AI systems
 Author-email: Laurent-Philippe Albou <contact@abstractcore.ai>
 License-Expression: MIT
@@ -615,6 +615,37 @@ manager.set_tts_model("tts_models/en/ljspeech/glow-tts")
 # - "tts_models/en/ljspeech/glow-tts" (alternative fallback)
 # - "tts_models/en/ljspeech/tacotron2-DDC" (legacy)
 
+# === Audio Lifecycle Callbacks (v0.5.1+) ===
+
+# NEW: Precise audio timing callbacks for visual status indicators
+def on_synthesis_start():
+    print("🔴 Synthesis started - show thinking animation")
+
+def on_audio_start():
+    print("🔵 Audio started - show speaking animation")
+
+def on_audio_pause():
+    print("⏸️ Audio paused - show paused animation")
+
+def on_audio_resume():
+    print("▶️ Audio resumed - continue speaking animation")
+
+def on_audio_end():
+    print("🟢 Audio ended - show ready animation")
+
+def on_synthesis_end():
+    print("✅ Synthesis complete")
+
+# Wire up callbacks
+manager.tts_engine.on_playback_start = on_synthesis_start    # Existing (synthesis phase)
+manager.tts_engine.on_playback_end = on_synthesis_end        # Existing (synthesis phase)
+manager.on_audio_start = on_audio_start                      # NEW (actual audio playback)
+manager.on_audio_end = on_audio_end                          # NEW (actual audio playback)
+manager.on_audio_pause = on_audio_pause                      # NEW (pause events)
+manager.on_audio_resume = on_audio_resume                    # NEW (resume events)
+
+# Perfect for system tray icons, UI animations, or coordinating multiple audio streams
+
 # === STT (Speech-to-Text) ===
 
 def on_transcription(text):