text-transcripts

Transcript parsing, ASR command adapters, and native whisper.cpp support for moritzbrantner-video-analysis.

Feature flags

• external-tests: enables ignored CLI-backed smoke tests
• native: builds whisper.cpp support for offline transcription. Repository builds use vendor/whisper.cpp; crates.io builds must set WHISPER_CPP_SOURCE_DIR to a local whisper.cpp source checkout.

Stable contract

The stable surface is transcript contracts, segment/word normalization, SRT/WebVTT/plain/Whisper JSON parsing, formatting, conversion to TextSegmentContract, and transcript-specific text pipeline analyzers.

Quality and limits

Default package operations parse and format text only. ASR command adapters and native whisper.cpp transcription remain explicit runtime paths and are not invoked by default package-surface operations.

Example

use text_transcripts::{parse_whisper_json, TranscriptionContract};

let parsed = parse_whisper_json(include_bytes!("../../../../tests/fixtures/whisper-sample.json"))?;
let transcript = TranscriptionContract::from(parsed).normalized()?;

assert!(!transcript.text_or_joined().is_empty());
# Ok::<(), Box<dyn std::error::Error>>(())

Package surface

• Primary workflow: transcripts.parse parses plain text, Whisper JSON, SRT, or WebVTT into the normalized transcript contract.
• Workflow operations: transcripts.parse, transcripts.normalize, transcripts.formatSrt, transcripts.formatWebVtt, and transcripts.toTextSegments.
• Debug operations: describe inspects package metadata and operation support.
• Runtime support: pure Rust parsing/formatting package-surface operations are available through library, CLI, server, and WASM wrappers.
• Sample output includes title, message, summary, result, and operation-specific fields such as segments, text, srt, or webVtt.
• Package-surface operations do not invoke whisper.cpp or external ASR tools; native transcription remains feature-gated.

Native whisper.cpp

The transcript parsers are loadable in default builds. whisper.cpp catalog and model-store validation is available behind native; transcription only runs when the requested model file is present or an opt-in setup flow downloads it.

cargo test -p text-transcripts --features native,external-tests -- --ignored

Browser benchmarks cover parse, normalize, and SRT formatting workflows through bun run text-wasm:bench:all.

Related crates

• text-core
• video-analysis-ingest
• video-analysis-use-cases