v3.8.4

m-bain/whisperXv3.8.4Mar 25, 2026by Barabazs

AI Summary

Adds progress callbacks for transcription, alignment, and diarization functions, along with fixes for file handle leaks and word-level timestamps. Requires faster-whisper version 1.2.0 or higher.

Key Highlights

  • Added progress_callback to transcribe, align, and diarize functions
  • Fixed file handle leak in model_bytes reading
  • Restored word-level timestamps for unalignable characters (digits, symbols, foreign script)
  • Updated faster-whisper requirement to >= 1.2.0 for use_auth_token support

New Features

  • Added progress_callback support

Full Release Notes

## What's Changed
* feat: add progress_callback to transcribe, align, and diarize by @Barabazs in https://github.com/m-bain/whisperX/pull/1371
* fix: remove dead model_bytes read that leaked file handle by @Barabazs in https://github.com/m-bain/whisperX/pull/1381
* fix: restore word-level timestamps for unalignable characters by @Barabazs in https://github.com/m-bain/whisperX/pull/1386
* fix: require faster-whisper>=1.2.0 for use_auth_token support (#1385) by @Barabazs in https://github.com/m-bain/whisperX/pull/1388


**Full Changelog**: https://github.com/m-bain/whisperX/compare/v3.8.2...v3.8.4