Welcome!

Demo Narrations (Framed Narrations)

Narrations in Lupo allow you to synchronize audio with specific slides. It lets you specify the exact moment the narration should start playing, enhancing the coherence between the content and audio.

Audio Narration Format

Write the time in double parentheses at the start of the narration line, followed by the narration text. The time is counted from the start of the slide. Each field is one or two digits:

  • Seconds: ((1)) — the narration starts 1 second into the slide. Seconds-only goes up to ((99)); for anything longer, use minutes and seconds.
  • Minutes and seconds: ((3:2)) — the narration starts 3 minutes and 2 seconds into the slide.
  • Hours, minutes, and seconds: ((2:2:2)) — the narration starts 2 hours, 2 minutes and 2 seconds into the slide.

Seconds can carry a decimal fraction of up to three digits: ((5.5)) starts at 5.5 seconds. Comma-separated forms such as ((3, 2)) are not accepted. A marker in any other shape stops the build with the error "Invalid time format in file … Please verify if the time format is ((h:m:s.ms))".

Each narration is one line of the HTML comment. Put the time before the narration text with nothing else between them: the marker is removed before the line is spoken, and anything else on the line is read aloud.

Examples

Simple narration:

<!--
((10)) This narration will start playing at 10 seconds into the slide.
-->

Combining narrations:

<!--
((1)) at 1 second
((4)) at 4 seconds
...
-->

Lines without a time

On a slide where you use time markers, give every narration line one. A line without a marker is placed at the running total of the lengths of the lines above it, counted from the start of the slide — not after the timed line before it. In this example the second line starts as soon as the first line's own length has elapsed from the start of the slide, so it plays on top of the first line instead of after it:

<!--
((3)) at 3 seconds
This line does not play after the line above
-->

Overlapping narrations

If a marker points to a moment while an earlier narration is still playing, Lupo does not move either of them: both are mixed together in the audio. The build's "Possible overlaps detected" warning does not catch every case, so check each time against the length of the narration before it.