v0.3.99

KoljaB/RealtimeSTTv0.3.99Mar 21, 2025by KoljaB

AI Summary

This release introduces enhanced logging with a dedicated named logger, adds the ability to disable the Faster-Whisper VAD filter, improves audio worker debug logging, and fixes VAD callback timing issues.

Key Highlights

Enhanced logging with dedicated 'realtimestt' logger
Added faster_whisper_vad_filter parameter (default: True)
Improved audio worker debug logging
VAD callback adjustments for more accurate timing

New Features

Dedicated named logger 'realtimestt'
Structured logging with console and file handlers
faster_whisper_vad_filter parameter
Detailed audio device initialization logging
VAD callback timing fixes

Full Release Notes

# RealtimeSTT 0.3.99

#### 1. **Enhanced Logging Configuration**
   - Introduced a dedicated named logger `realtimestt` instead of using the root logger.
   - Added structured logging with handlers for both console (level set by user) and file (always DEBUG).
   - Logging no longer propagates to the root logger by default (`logger.propagate = False`).

#### 2. **Added possibility to disable Faster-Whisper VAD Filter**
   - Added `faster_whisper_vad_filter` parameter (default: `True`) to enable voice activity detection (VAD) from the `faster_whisper` library.
   - Improves robustness against background noise at the cost of additional GPU resources.
   - Integrated into both real-time and main transcription workflows.

#### 3. **Audio Worker Improvements**
   - Added improved, detailed debug logging for audio device initialization, sample rate handling, and resampling.

#### 4. **VAD Callback Adjustments**
   - fixes #215
   - Moved `on_vad_detect_start` and `on_vad_detect_stop` callbacks to trigger directly during voice activity checks instead of state transitions.
   - Ensures callbacks align more accurately with actual speech/silence events.