Examples

Runnable sample scripts, kept in sync with the repository’s examples/ directory.

cold_open.podscript

podscript: "0.2.0"

# cold_open.podscript — canonical example
#
# Intro music plays at -3 dB, fades out over 4s starting at 8s, and Sam's
# narration begins exactly as the fade starts (overlapping the fading tail).

meta:
  title: "Episode 12 — The Thing"
  lufs: -16
  true_peak: -1

voices:
  sam:  { voice: Adam,   preset: host }
  alex: { voice: Rachel, preset: warm-host }

assets:
  intro:  music/intro_theme.mp3  once
  outro:  music/outro_theme.mp3  once
  whoosh: sfx/whoosh_01.wav

scene cold_open:
  bed intro gain -3db fade-out over 4s at 8s        #music
  sam [with intro.fade-out]: Hey everyone — welcome to the show. Today we're *digging in*...
  alex: ...and it's a strange one.
  sfx whoosh after alex

scene main:
  bed intro gain -8db fade-in over 1s duck-under speech to -18db
  sam: So here's where it gets interesting.
  alex (skeptical): Does it, though?

scene outro:
  # outro music segues in over the intro bed and plays out under the sign-off
  bed outro gain -6db crossfade 2s fade-out over 3s at signoff.end
  sam: That's all for this week — thanks for listening.   #signoff

minimal.podscript

podscript: "0.2.0"

voices:
  host:  { voice: Adam,   preset: host }
  guest: { voice: Rachel, preset: warm-host }

assets:
  theme: music/theme.mp3 once

scene open:
  bed theme gain -4db duck-under speech to -15db fade-out over 3s at 12s
  host: Welcome back to the show — I'm here with our guest.
  guest (warm): Thanks for having me.
  host: Let's get into it.

prosody.podscript

podscript: "0.2.0"

# prosody.podscript — controlling delivery
#
# Prosody is *how* a line is spoken. Sam has a brisk, slightly low baseline;
# individual lines override rate / pitch / volume. Within-sentence variation is
# authored as consecutive cues, each with its own prosody.

voices:
  sam:  { voice: Adam,   preset: host, prosody: { rate: 1.1, pitch: -1st } }
  alex: { voice: Rachel, preset: warm-host }

scene demo:
  sam: Normal delivery for the setup — this uses Sam's baseline.
  sam [prosody rate 1.35 pitch +3st volume 1.2] (excited): Wait — it actually *worked*!
  sam [prosody rate 0.9]: ...which, if you think about it, changes everything.
  alex (skeptical): Does it, though?