DOCS/OPERATIONS & PUBLISHING/Troubleshooting & FAQ

Troubleshooting & FAQ

Common gate errors, remedies, crash resume ledger, licensing, and FAQ.

Actionable solutions for pipeline gate errors, crash recovery mechanisms, and licensing questions.

Gate Error Matrix

STAGE	GATE ERROR	CAUSE & 1-LINE FIX
01	FAIL: source diversity < 2 distinct domains	Research only cited a single website. Fix: Perform broader searches and cite at least two independent domains in raw.md.
02	FAIL: Word count outside 100–130 spoken words	Script in final.md is too short or too long for short format. Fix: Trim or expand narration text to exactly 100–130 words.
02	FAIL: Missing phoneme entry for entity	A proper noun in final.md lacks an Arpabet mapping. Fix: Add the word and its Arpabet phonetic sequence under phonemes: in config.yaml.
08	FAIL: Loudness outside −14.0 LUFS	Master audio volume deviated from broadcast standards. Fix: Run shorts qc --loudfix to automatically remaster audio.
08	Render queue lock contention	A previous render was aborted before releasing its lock. Fix: Run rm -f .render.lock to clear the lock.

Crash Recovery & Resume

Every stage execution records a PASS marker to series/<series>/logs/<slug>.log.

If a run is interrupted by network loss, power cuts, or manual cancellation, simply re-run run <series>. The engine reads the log and automatically resumes from the exact stage that was interrupted, skipping all previously completed work.

Commercial FAQ

Can I monetize shorts produced with this engine?

Yes. All scripts, visuals, and rendered videos belong 100% to you to monetize across YouTube Shorts, TikTok, and Instagram Reels.

What are the real ongoing costs per video?

Fish Audio TTS voice synthesis costs under $0.01 per short. All other components (Whisper transcription, OCR, Ken Burns rendering, audio mastering) run 100% locally on your machine at $0.00.

Which operating systems are supported?

Linux, macOS (Apple Silicon M1/M2/M3/M4 & Intel), and Windows via WSL2.

Was this "Troubleshooting & FAQ" page helpful?

YouTube Publishing

Permission-gated uploads, channel auto-resolution, tags, and OAuth management.

Terms & Conditions

Commercial software license agreement, node-locking rules, and user terms.