src/video_forge/templates/stories_of_the_ummah/universal_story.json

{
  "name": "universal_story",
  "series": "Stories of the Ummah or any historical world",
  "episode": 0,
  "title": "Replace with a verified story title",
  "source": "Required: cite and verify the primary source, translation, or historical record before publication.",
  "story": {
    "genre": "faith|ancient-civilization|historical|realistic|futuristic|original-fiction",
    "era": "Set the real or imagined timeline.",
    "location": "Set the geographic or fictional location.",
    "audience": "General audience",
    "content_boundaries": ["Do not invent sacred facts", "Do not depict prophets or sacred figures directly", "Label fiction and dramatization clearly"],
    "arc": ["hook", "setting", "inciting_event", "escalation", "moral_choice", "turning_point", "resolution", "reflection"]
  },
  "video": {
    "width": 1080,
    "height": 1920,
    "fps": 30,
    "aspect": "9:16",
    "duration_mode": "narration_driven",
    "target_seconds": 60,
    "crossfade_seconds": 0.22,
    "codec": "libx264",
    "crf": 18,
    "preset": "medium",
    "pixel_format": "yuv420p",
    "faststart": true
  },
  "visual_style": {
    "palette": "golden|sunset|desert|storm|cave|night|celestial|custom",
    "render_mode": "cinematic_2d|procedural|faceless_documentary|illustrated",
    "camera": "slow_push|slow_pull|parallax|handheld_subtle|locked|custom",
    "safe_area": {"subtitle_center_y": 1640, "horizontal_padding": 60},
    "mastering": {"lut": "warm_teal_orange", "grain": 0.02, "vignette": 0.35, "color_grade": true}
  },
  "environments": [
    {"name": "desert", "background": "dunes_and_sandstone", "lighting": "golden_hour", "atmosphere": ["dust", "haze", "sun_glare"]},
    {"name": "cave", "background": "dark_rock", "lighting": "narrow_volumetric_shaft", "atmosphere": ["dust", "impact_debris"]},
    {"name": "storm", "background": "clouded_sky", "lighting": "cold_diffuse", "atmosphere": ["rain", "wind", "lightning_optional"]},
    {"name": "celestial", "background": "star_field", "lighting": "soft_rim", "atmosphere": ["rings", "stars", "nebula_optional"]},
    {"name": "future", "background": "architectural_orbital_space", "lighting": "neon_rim", "atmosphere": ["particles", "holographic_haze"]}
  ],
  "characters": {
    "policy": "Use faceless or respectful silhouettes for sacred and historical subjects. Do not generate a prophet's face or claim an invented likeness.",
    "types": ["traveler", "elder", "woman", "child", "animal", "angelic_silhouette", "civilization_group", "future_explorer", "custom_silhouette"],
    "poses": ["walk_rear", "push_rock", "dua_kneel", "serve_standing", "turn_away", "kneel_offer", "panting", "drinking", "healthy_standing", "rear_stand", "rear_hands_lifted", "glorify", "humility"],
    "interaction_targets": ["none", "rock", "water", "animal", "light", "artifact", "vehicle", "custom"]
  },
  "effects": {
    "particles": {"enabled": true, "types": ["dust", "sparkle", "rain", "embers", "stars"], "count": 30, "seed": 42},
    "lighting": ["sun_glare", "volumetric_rays", "lantern_flicker", "celestial_rings"],
    "transitions": ["crossfade", "dream_flare", "light_bloom", "dust_dissolve", "hard_cut"],
    "motion": ["ken_burns", "parallax", "cloth_sway", "breathing", "water_ripple", "impact_shake"]
  },
  "audio": {
    "sample_rate": 44100,
    "narration": "Use a clear, respectful documentary voice. Generate from the verified script and never imitate a real reciter.",
    "music": "Use only license-cleared ambient music or environmental sound. Match the era and mood without overpowering speech.",
    "sound_design": ["rain", "wind", "rock_impact", "water", "footsteps", "room_tone", "hopeful_resolution"],
    "timing": "narration_driven",
    "mix": "Keep narration dominant, duck music 8-12 dB during speech, target -3 dBFS narration peak, leave headroom, and check for clipping.",
    "delivery": "AAC 192-256 kbps stereo, -16 to -14 LUFS integrated target where the platform permits"
  },
  "captions": {"enabled": true, "mode": "kinetic_safe_area", "max_words_per_line": 8, "burn_in": true, "language": "en"},
  "thumbnail": {"enabled": true, "aspect": "9:16", "text": "Use a short curiosity hook", "safe_area": true},
  "seo": {"enabled": true, "title": "Verified story title + series/episode", "description": "Summary, source note, timestamps, reflection, and disclosure.", "tags": ["storytelling", "shorts", "history"], "hashtags": ["#shorts"]},
  "scenes": [
    {"id": "hook", "duration": null, "renderer": "environment_wide", "environment": "desert", "camera": {"zoom_start": 1.0, "zoom_end": 1.08, "pan": [0, 0]}, "characters": [{"type": "traveler", "pose": "walk_rear", "count": 1}], "effects": ["dust", "sun_glare"], "transition": "crossfade", "transition_seconds": 0.22, "subtitle": "Open with a specific hook.", "vo": "Open with a specific hook grounded in the verified story."},
    {"id": "conflict", "duration": null, "renderer": "environment_action", "environment": "storm", "camera": {"zoom_start": 1.04, "zoom_end": 1.0, "pan": [0.1, 0]}, "characters": [], "effects": ["rain", "impact_shake"], "transition": "crossfade", "transition_seconds": 0.22, "subtitle": "Introduce the central test.", "vo": "Introduce the central test without adding unsupported details."},
    {"id": "choice", "duration": null, "renderer": "character_silhouette", "environment": "cave", "camera": {"zoom_start": 1.0, "zoom_end": 1.05, "pan": [0, -0.05]}, "characters": [{"type": "custom_silhouette", "pose": "dua_kneel", "count": 1}], "effects": ["volumetric_rays", "dust"], "transition": "dream_flare", "transition_seconds": 0.22, "subtitle": "Show the moral choice.", "vo": "Show the moral choice and distinguish sourced facts from reflection."},
    {"id": "resolution", "duration": null, "renderer": "environment_wide", "environment": "celestial", "camera": {"zoom_start": 1.06, "zoom_end": 1.0, "pan": [0, 0]}, "characters": [{"type": "traveler", "pose": "walk_rear", "count": 1}], "effects": ["sparkle", "hopeful_resolution"], "transition": "crossfade", "transition_seconds": 0.22, "subtitle": "End with the lesson and source note.", "vo": "End with a concise reflection and remind viewers to verify the source before sharing."}
  ]
}