xikratosx/narrated-video-maker repository overview

⁠📦 Narrated Video Maker

⁠🧠 Overview

Narrated Video Maker is an enhanced AI-powered video generation system designed to automatically create high-quality narrated videos for YouTube, TikTok, Instagram Reels, and other content platforms.

Built as a modified and improved version of the original Narrated Story Creator, this Docker image provides a more flexible, customizable, and production-ready solution for creators, developers, and automation workflows.

⁠🚀 What It Does

This system transforms simple input data into fully rendered videos:

1. 📝 Text → AI Voice Narration
2. 🖼️ Character / Avatar Integration
3. 🎬 Background Video Processing
4. 🎞️ Final Video Rendering

👉 Output: Ready-to-publish narrated video

⁠⚙️ Key Features

• 🔊 Advanced AI voice generation (customizable TTS support)
• 🎯 High-quality video rendering using FFmpeg
• 🧩 Modular and scalable architecture
• ⚡ Optimized for automation workflows (n8n, APIs, etc.)
• 🔗 REST API for full control
• 🛠️ Easy customization and extensibility

⁠🧰 Tech Stack

• 🎙️ AI Text-to-Speech Engine (Speechma / Custom TTS)
• 🎬 FFmpeg (Video Processing & Rendering)
• 🐳 Docker (Containerized Deployment)
• 🌐 REST API Server

⁠🔌 API Endpoints

⁠Core Routes

• GET /health → Check server status
• GET /api/videos → List all videos
• POST /api/videos → Create a new video
• GET /api/videos/:id → Retrieve video details
• GET /api/videos/:id/status → Check processing status
• DELETE /api/videos/:id → Delete a video
• GET /api/queue → View processing queue

⁠📥 Input Parameters

⁠Required

• text → Narration script
• person_image_url → Character / avatar image
• bg_video_url → Background video
• person_name → Character identity

⁠Optional

• voice → Select AI voice
• language → Specify language (auto-detection supported)

⁠🤖 Automation Ready

This system is built for seamless automation:

• ✅ n8n workflows
• ✅ AI agent integrations (MCP support)
• ✅ Backend for SaaS platforms
• ✅ Bulk video generation pipelines

⁠🧩 MCP Support

⁠Endpoints

• /mcp/sse
• /mcp/messages

⁠Tools

• create_video_mcp
• list_languages_mcp

⁠📦 Docker Usage

⁠Pull Image

docker pull xikratosx/narrated-video-maker:latest