Add TheBoldFont to static/fonts and use for all captions + add captions to story_reels

modules/story_reels/services/story_creator.py

@@ -428,7 +428,8 @@ class StoryCreator:
             await self._compose_video(
                 scenes=generated_scenes,
                 audio_path=mp3_path,
-                output_path=output_path
+                output_path=output_path,
+                captions=captions_dict
             )
             
             job["video_url"] = f"/videos/{job_id}.mp4"
@@ -457,7 +458,8 @@ class StoryCreator:
         self,
         scenes: List[Dict],
         audio_path: Path,
-        output_path: Path
+        output_path: Path,
+        captions: List[Dict] = None
     ):
         """
         Compose video from images and audio using MoviePy.
@@ -466,12 +468,14 @@ class StoryCreator:
         - Crossfade transitions (0.3s) between scenes
         - Subtle Ken Burns zoom (1.05x) for dynamic feel
         - Fade in at start, fade out at end
+        - Word-by-word captions
         """
         from moviepy.editor import (
             ImageClip, 
             AudioFileClip, 
             concatenate_videoclips,
             CompositeVideoClip,
+            TextClip,
             vfx
         )
         
@@ -557,6 +561,62 @@ class StoryCreator:
         
         video = video.set_audio(audio)
         
+        # ====================
+        # Add Captions Overlay
+        # ====================
+        if captions:
+            logger.info(f"Adding {len(captions)} captions to video...")
+            
+            # Find font - Priority: TheBoldFont (static/fonts) > DejaVu > Liberation
+            thebold_path = Path(__file__).parent.parent.parent.parent / "static" / "fonts" / "THEBOLDFONT-FREEVERSION.ttf"
+            dejavu_path = Path("/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf")
+            liberation_path = Path("/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf")
+            
+            if thebold_path.exists():
+                font_name = str(thebold_path)
+            elif dejavu_path.exists():
+                font_name = str(dejavu_path)
+            elif liberation_path.exists():
+                font_name = str(liberation_path)
+            else:
+                font_name = "DejaVu-Sans-Bold"
+            
+            caption_clips = []
+            y_pos = TARGET_HEIGHT * 0.75  # 75% down (bottom area)
+            
+            for cap in captions:
+                start_time = cap.get("startMs", 0) / 1000
+                end_time = cap.get("endMs", 0) / 1000
+                duration = end_time - start_time
+                text = cap.get("text", "")
+                
+                if duration <= 0 or not text:
+                    continue
+                
+                try:
+                    txt_clip = TextClip(
+                        text,
+                        fontsize=60,
+                        color="white",
+                        font=font_name,
+                        stroke_color="black",
+                        stroke_width=2,
+                        method="caption",
+                        size=(int(TARGET_WIDTH * 0.9), None),
+                        align="center"
+                    )
+                    txt_clip = txt_clip.set_duration(duration)
+                    txt_clip = txt_clip.set_start(start_time)
+                    txt_clip = txt_clip.set_position(("center", y_pos))
+                    caption_clips.append(txt_clip)
+                except Exception as e:
+                    logger.warning(f"Caption failed: {e}")
+                    continue
+            
+            if caption_clips:
+                video = CompositeVideoClip([video] + caption_clips)
+                logger.info(f"Added {len(caption_clips)} caption clips")
+        
         # Write final video
         logger.info(f"Writing video with effects: crossfade={CROSSFADE_DURATION}s, zoom={ZOOM_FACTOR}x")
         video.write_videofile(

modules/video_creator/services/libraries/video_composer.py

@@ -285,19 +285,19 @@ class VideoComposer:
                 # Allocating 20% of height for caption box
                 
                 # Try local font first, then system fonts
-                font_path = Path(__file__).parent.parent.parent / "static" / "fonts" / "TheBoldFont.ttf"
-                if font_path.exists():
-                    font_name = str(font_path)
+                # Priority: TheBoldFont (static/fonts) > DejaVu > Liberation
+                thebold_path = Path(__file__).parent.parent.parent.parent.parent / "static" / "fonts" / "THEBOLDFONT-FREEVERSION.ttf"
+                dejavu_path = Path("/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf")
+                liberation_path = Path("/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf")
+                
+                if thebold_path.exists():
+                    font_name = str(thebold_path)
+                elif dejavu_path.exists():
+                    font_name = str(dejavu_path)
+                elif liberation_path.exists():
+                    font_name = str(liberation_path)
                 else:
-                    # Use DejaVu (installed in Dockerfile) - full path for Linux
-                    dejavu_path = "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf"
-                    liberation_path = "/usr/share/fonts/truetype/liberation/LiberationSans-Bold.ttf"
-                    if Path(dejavu_path).exists():
-                        font_name = dejavu_path
-                    elif Path(liberation_path).exists():
-                        font_name = liberation_path
-                    else:
-                        font_name = "DejaVu-Sans-Bold"  # Fallback name
+                    font_name = "DejaVu-Sans-Bold"  # Fallback name
                 
                 txt_clip = TextClip(
                     caption["text"],