DOCS/CORE ARCHITECTURE/Series Configuration

Series Configuration

Series settings, voice profiles, subtitle styling, and custom channel mappings.

Each series maintains its own configuration file defining format, voice persona, typography, and phonetic pronunciation overrides.

Series Workspace Layout

Scaffolding a series creates isolated folders for scripts, images, and progress logs:

SERIES WORKSPACE

series/<series>/

config.yamlseries settings: format, voice, captions, channel

used_topics.mdtopic deduplication ledger

research/research notes & fact verification

scripts/<slug>/one folder per video

raw.md → final.mdverified research → retention script

audio.wav · subtitles.srtnarration + word-timed captions

needs.md · plan.yamlshot plan consumed by the renderer

short.mp4the finished, QC-passed video

images/reusable library + characters.json

raw-images/download scratch & OCR gate

logs/per-script stage execution ledger

ASSET LIBRARY

shared/

background_music/84 BGM tracks

sfx/57 sound effects

fonts/62 headline & subtitle fonts

visual_effects/15 overlay textures

LOCAL SECRETS

secrets/gitignored — never leaves your machine

fish_api_key.txtFish Audio voice key

youtube/channels.jsonchannel registry

youtube/<Channel>/OAuth client_secret.json + token.json

config.yaml Reference

The config.yaml file is auto-discovered by all pipeline stages:

series/<series>/config.yaml

1format: short # "short" (9:16 1080x1920) or "long" (16:9 1920x1080)

2description: "Historical mysteries and bizarre true stories."

3channel: Curiosity2Corner

4voice: horror

5tts:

6 speed: 1.15

7 min_words: 100 # 100-130 for shorts, 800-3500 for long-form

8 max_words: 130

9subtitles:

10 font: fonts/playfairdisplay_800_v1.ttf

11 fill: "#fdfcf8"

12 highlight: "#e7c65a"

13 stroke: "#0a0a0a"

14phonemes:

15 Frieren: F R IY1 R AH0 N

16 Zoltraak: Z OW0 L T R AA1 K

17image:

18 sources: [google, bing, duckduckgo, wikimedia]

19 min_width: 640

Configuration Fields

FIELD	TYPE	DEFAULT	DESCRIPTION
format	string	short	"short" (9:16 vertical 1080x1920) or "long" (16:9 horizontal 1920x1080).
description	string	—	Series identity & domain scope passed to research agents.
channel	string	Auto	Target YouTube channel name matching secrets/youtube/.
voice	string	horror	Fish Audio voice preset or clone reference ID.
tts.speed	float	1.15	Speech playback multiplier (1.0 to 1.3).
tts.min/max_words	int	100–130	Target word count (100–130 for shorts, 800–3500 for long-form).
subtitles.font	path	playfair	Path to TTF font under shared/fonts/.
subtitles.fill/highlight	hex color	#fdfcf8 / #e7c65a	Base text color and active karaoke highlight word color.
phonemes	mapping	{}	CMU Arpabet pronunciation overrides for proper nouns.
image.sources	list	[google, bing, ddg, wikimedia]	Active scraping sources for Stage 06 image search.

Was this "Series Configuration" page helpful?

Pipeline & Architecture

High-level overview of the 10-stage pipeline, parallel branches, and quality gates.

Production Asset Libraries

Using and customizing 84 BGM tracks, 57 SFX beds, 62 fonts, and reusable image stock.