FIELD GUIDE

aeneas Forced Alignment: Timestamping Known Narration Under an AGPL License

The editorial decision

When a narrator has already recorded the final script, there is no need to ask a speech recognizer to guess every word again merely to find timecodes. Aeneas is an older forced-alignment project that maps supplied text fragments to the corresponding audio timeline. That makes it relevant to audiobook chapters and educational videos, even though its software history predates current generative AI products.

What primary documentation actually establishes

The ReadBeyond repository describes a Python/C alignment library, examples that synchronize text and audio and the AGPLv3 licensing. Its listed version 1.7.3 dates to March 2017. Alignment means matching an existing transcript to the waveform; it is not a new transcript generator, diarization service, translation system or verification that the words are factually correct. Local installation dependencies and runtime support require review on contemporary operating systems.

A concrete production workflow

For a ten-minute narrated explainer, split the approved script into sentence-level fragments with stable IDs. Export final voiceover audio without sound effects if possible, normalize the encoding, then run the alignment tool against the same edition of the script. Save the alignment map and use it to draft captions or trigger scene cuts. If the narrator skipped a phrase or improvised, correct the script or mark that segment for manual editing; do not try to force an exact text where no corresponding speech exists.

Failure modes and limitations

Alignment deteriorates around music beds, inserted B-roll narration, repeated phrases and speech omitted from the reference text. Fragment-level timing is not necessarily the same as accurate phoneme-level or word-level timing. Older dependency stacks add maintenance and security costs, and an AGPL obligation cannot be dismissed by saying that the tool is free.

A practical evidence and listening test

Compare 30 manually timestamped phrases spanning fast speech, breathing gaps, proper names and the ends of the recording. Report absolute time error and the percentage of cues requiring adjustment. Include edits made after alignment, because an untouched automatic timeline is not a publication-quality guarantee. This archive did not execute aeneas or publish benchmark outcomes.

Rights, consent and responsible handling

Check AGPL obligations and third-party dependency licenses before incorporating aeneas into a distributed or network-accessible product. All voiceover recordings and underlying scripts need rights clearance. A timecode engine cannot authorize a cloned voice or republishing someone else’s narration.

Alternatives and buying decision

Cloud forced-alignment APIs can reduce local packaging complexity, while modern local ASR/CTC aligners offer other model choices. Choose by language, timecode granularity, maintainability and license rather than year of release alone.

Sources & Further Reading

Editorial cutoff 25 October 2026. We have not performed live API testing or independent product benchmarking. Reconfirm your region, plan, model revision, licensing and current prices before deployment.

CONTINUE EXPLORINGExplore related files ↗