HeyGen article examples (50590)

HeyGen article examples (50590)

End-to-end workflow for a HeyGen talking-head video, Whisper transcript timing, slide deck layouts, PiP calibration, and five media variant MP4 exports.

Overview of all new video/PiP features: Recent features.

Full pipeline (video + transcript → YAML → PPTX → MP4), automation gaps, and checklists: Video + transcript workflow.

Repository paths are under examples/ in the PraisonAIPPT repo.

Workflow overview

flowchart LR
  A[heygen-50590-content.yaml] --> B[sync_heygen_variants.py]
  B --> C[Variant YAMLs]
  C --> D[praisonaippt build]
  D --> E[PPTX + slide JPEGs]
  D --> F[MP4 export]

Presenter narration for captions lives in each verse notes field. Slide headlines and deck layouts follow the Claude Managed Agents article (May 2026).

Shared assets (~57 s)

Narration source (pick one)

1. Default — HeyGen video audio — narration_mode: avatar or audio_source: heygen_video. Lip-sync / TTS from the MP4 track.
2. Optional — video + separate MP3 — narration_mode: audio_file or audio_source: external. PiP video is visual-only for audio; MP3 drives timing and voice.
3. TTS — narration_mode: tts. Synthesise from verse notes; avatar video is muted for narration.

With narration_mode: auto, HeyGen embedded audio wins when the avatar file has a track, even if audio_path is also set on the verse. See Video export — narration modes.

Variant matrix

Images variant (full-bleed product heroes)

Separate from the five media variants — same HeyGen MP4 + Whisper timings as heygen-50590-video-audio-heygen.yaml, with product screenshots and floating headline panels:

# Key settings (see file for full deck)
skip_title_slide: true
slide_style:
  layouts:
    avatar_media_3:
      hero_layout: full_bleed
      text_style: semi_panel
pipeline:
  golden_slide_dir: slide_images/heygen-50590-images/golden
  export_mp4_frames: true

praisonaippt -i examples/heygen-50590-video-audio-heygen-images.yaml \
  -o examples/heygen-50590-video-audio-heygen-images.pptx \
  --convert-video --video-output examples/heygen-50590-video-audio-heygen-images.mp4

praisonaippt validate-deck -i examples/heygen-50590-video-audio-heygen-images.yaml

Docs: Avatar layouts — full-bleed hero · Slide QA

Build one variant

VARIANT=heygen-50590-video-audio-heygen

python -m praisonaippt.cli \
  -i examples/${VARIANT}.yaml \
  -o examples/${VARIANT}.pptx \
  --convert-video \
  --video-output examples/${VARIANT}.mp4 \
  --no-list-slides

video_export.narration_mode in each variant YAML is applied automatically; no extra CLI flag is required.

Build all showcase outputs

python examples/sync_heygen_variants.py
python examples/build_showcase_examples.py

Rebuilds avatar gallery, deck gallery, and all five HeyGen variant PPTX + MP4 files.

Generate variant YAMLs from Whisper JSON

python -m praisonaippt.cli transcript-to-yaml \
  -i examples/short-script-50590_timestamps.json \
  -o examples/heygen-article-50590 \
  --variants all

Writes combination decks (same presets as MEDIA_VARIANTS in code). For the maintained article deck, prefer content + sync above.

Related configuration

Legacy filenames

Source of truth in repo

The canonical copy for editors is examples/heygen-50590-examples.md (mirrors this page). After editing content, run sync_heygen_variants.py before building variants.