mixing.transcript.formats

Transcript output formats: SRT, plain prose, time remapping.

Functions

remap_time_after_cuts(t, cuts)	Map t from the original timeline onto the post-cut timeline.
words_to_prose(words, *[, paragraph_pause, ...])	Render a Scribe word list as plain prose, with paragraph breaks on long pauses.
words_to_srt(words, *[, max_chars, ...])	Render an SRT from a Scribe word list (no filler removal, no remapping).
words_to_srt_remapped(words, cuts, *[, ...])	SRT aligned to a post-cut timeline.

mixing.transcript.formats.remap_time_after_cuts(t, cuts)

Map t from the original timeline onto the post-cut timeline.

If t falls inside a cut, snaps to the moment that cut would have started in the post-cut timeline.

Return type:

float

mixing.transcript.formats.words_to_prose(words, *, paragraph_pause=1.2, drop_fillers=False, fillers=frozenset({'ah', 'eh', 'er', 'erm', 'hmm', 'mhm', 'mm', 'mmm', 'uh', 'uhh', 'uhm', 'um', 'umm'}), audio_events=frozenset({'(coughs)'}))

Render a Scribe word list as plain prose, with paragraph breaks on long pauses.

Parameters:

• words (Sequence[dict]) – Scribe words array.

• paragraph_pause (float) – Insert a blank line when the gap between two consecutive non-filler words exceeds this many seconds.

• drop_fillers (bool) – If True, omit filler words and removable audio events.

• audio_events (Iterable[str]) – Override the default filler / event sets.

Return type:

str

mixing.transcript.formats.words_to_srt(words, *, max_chars=80, sentence_endings='.?!')

Render an SRT from a Scribe word list (no filler removal, no remapping).

Return type:

str

mixing.transcript.formats.words_to_srt_remapped(words, cuts, *, max_chars=80, sentence_endings='.?!', drop_fillers=True, fillers=frozenset({'ah', 'eh', 'er', 'erm', 'hmm', 'mhm', 'mm', 'mmm', 'uh', 'uhh', 'uhm', 'um', 'umm'}), audio_events=frozenset({'(coughs)'}))

SRT aligned to a post-cut timeline.

Each word’s timestamp is shifted earlier by the cumulative duration of all cuts that ended before it, so the resulting SRT drops in over the cleaned media.

Return type:

str