Prompt file imported from vinayakv22/insanely-fast-whisper-rocm (
.windsurf/workflows/srt-benchmark.md). Copyright stays with the author.
SRT quality benchmark workflow
Purpose
Guide to regenerate benchmarks, collect SRT quality metrics, and compare word vs chunk timestamp behavior.
Steps
-
Reset artifacts (only after recent code changes that could effect benchmarks)
scripts/clean_benchmark.shRemoves cached benchmark JSON, SRT, and TXT files so the new run is isolated.
-
Run word-level benchmark variants
Choose one of the files below that best matches what kind of benchmark we want to test:
uploads/Weighted_Scorecard_vs_5_minute_test.mp3(short)uploads/Weighted_Scorecard_vs_medium_test.mp3(medium)uploads/Weighted_Scorecard_vs.mp3(large +- 17 minutes)
scripts/benchmark.sh -a "uploads/Weighted_Scorecard_vs_5_minute_test.mp3" \ -m distil-whisper/distil-large-v3.5 \ --timestamp-types word \ --batch-word 4Captures baseline, stabilize, demucs, VAD, and combination variants with word timestamps.
-
Run chunk-level baseline (fallback validation)
scripts/benchmark.sh -a "uploads/Weighted_Scorecard_vs_5_minute_test.mp3" \ -m distil-whisper/distil-large-v3.5 \ --timestamp-types chunkProduces JSON/SRT outputs that rely on the chunk fallback path to confirm duration splitting behavior.
-
Inspect benchmark JSON metrics
# Example: open baseline JSON sed -n '1,160p' benchmarks/Weighted_Scorecard_vs_5_minute_test_transcribe_<timestamp>.jsonFocus on
format_quality.srt.score,duration_stats,boundary_counts,cps_histogram, andsample_offenders. -
Compare word vs chunk results
- Quality score: confirm chunk fallback raises
scorewhen word segmentation still has long spans. - Durations: note
duration_stats.max_secondsandboundary_counts.too_longdifferences. - CPS: verify
cps_histogramand offender lists reflect improvements with fallback.
- Quality score: confirm chunk fallback raises
-
Review SRT outputs for timing accuracy
head -n 80 transcripts-srt/Weighted_Scorecard_vs_5_minute_test_transcribe_<timestamp>.srtCompare word-based vs chunk-based SRT files to assess alignment vs readability trade-offs.
-
Document findings
Summarize observed improvements or regressions (e.g., more balanced durations, remaining boundary violations) and note follow-up actions for
segment_words()orcompute_srt_quality().
