minor update

Author: KoljaB

README.md

@@ -30,7 +30,7 @@ https://github.com/user-attachments/assets/797e6552-27cd-41b1-a7f3-e5cbc72094f5
 
 ### Updates
 
-Latest Version: v0.3.100
+Latest Version: v0.3.104
 
 See [release history](https://github.com/KoljaB/RealtimeSTT/releases).
 
@@ -477,6 +477,8 @@ When you initialize the `AudioToTextRecorder` class, you have various options to
 
 - **no_log_file** (bool, default=False): If set, the system will skip writing the debug log file, reducing disk I/O. Useful if logging to a file is not needed and performance is a priority.
 
+- **start_callback_in_new_thread** (bool, default=False): If set, the system will create a new thread for all callback functions. This can be useful if the callback function is blocking and you want to avoid blocking the realtimestt application thread. 
+
 #### Real-time Transcription Parameters
 
 > **Note**: *When enabling realtime description a GPU installation is strongly advised. Using realtime transcription may create high GPU loads.*

RealtimeSTT/audio_recorder.py

@@ -334,6 +334,7 @@ def __init__(self,
                  use_extended_logging: bool = False,
                  faster_whisper_vad_filter: bool = True,
                  normalize_audio: bool = False,
+                 start_callback_in_new_thread: bool = False,
                  ):
         """
         Initializes an audio recorder and  transcription
@@ -566,6 +567,10 @@ def __init__(self,
         - normalize_audio (bool, default=False): If set to True, the system will
             normalize the audio to a specific range before processing. This can
             help improve the quality of the transcription.
+        - start_callback_in_new_thread (bool, default=False): If set to True,
+            the callback functions will be executed in a
+            new thread. This can help improve performance by allowing the
+            callback to run concurrently with other operations.
 
         Raises:
             Exception: Errors related to initializing transcription
@@ -681,6 +686,7 @@ def __init__(self,
         self.faster_whisper_vad_filter = faster_whisper_vad_filter
         self.normalize_audio = normalize_audio
         self.awaiting_speech_end = False
+        self.start_callback_in_new_thread = start_callback_in_new_thread
 
         # ----------------------------------------------------------------------------
         # Named logger configuration
@@ -1015,8 +1021,12 @@ def _transcription_worker(*args, **kwargs):
         worker.run()
 
     def _run_callback(self, cb, *args, **kwargs):
-        if cb:
+        if self.start_callback_in_new_thread:
+            # Run the callback in a new thread to avoid blocking the main thread
             threading.Thread(target=cb, args=args, kwargs=kwargs, daemon=True).start()
+        else:
+            # Run the callback in the main thread to avoid threading issues
+            cb(*args, **kwargs)
 
     @staticmethod
     def _audio_data_worker(

setup.py

@@ -14,7 +14,7 @@
 
 setuptools.setup(
     name="realtimestt",
-    version="0.3.103",
+    version="0.3.104",
     author="Kolja Beigel",
     author_email="kolja.beigel@web.de",
     description="A fast Voice Activity Detection and Transcription System",