Movie Narrator

Movie Narrator 是一个功能强大的开源工具包，通过简单的命令行指令，自动生成带有旁白、字幕和渲染输出的电影解说视频。它将 LLM 脚本创作、TTS 语音合成、场景匹配和视频渲染整合到一个流水线中，让创作者只需提供一个电影名称和风格提示，即可快速产出高质量的短视频内容。

核心功能亮点

1. LLM 驱动的智能脚本
   • 根据电影元数据自动生成解说脚本。
   • 支持多种叙述者视角（全知上帝视角、角色代入、侦探推理）。
   • 集成 TMDB 事实核查，确保剧情描述的准确性并标注来源。
2. 高质量音频与字幕
   • TTS 旁白：默认集成 Edge-TTS，支持多种音色和情感控制。
   • 自动字幕：生成同步的 SRT 字幕，支持通过 LLM 翻译成多语言或双语字幕。
   • 背景音乐：自动集成 BGM，并与旁白进行音量平衡混合。
3. 智能场景匹配与渲染
   • VLM 场景理解：通过云端视觉语言模型 API 识别电影片段中的具体场景。
   • 参考视频模仿：上传爆款解说视频作为参考，自动提取其剪辑节奏和风格进行模仿。
   • 多候选赛马 (Race)：一次生成 N 个不同风格的变体，自动评估并挑选最佳版本。
   • 模板系统：支持自定义标题卡、水印和标语，输出 1080p 或 4K 视频。
4. 灵活的架构与部署
   • 插件化设计：支持自定义 LLM 后端（Ollama, GLM, Qwen 等）和 TTS 引擎。
   • Web UI & API：提供独立的 Web 界面包 (movie-narrator-web) 和 REST API，支持异步任务提交和远程推理。
   • QA 检测：内置黑帧和幻灯片风险检测，确保最终视频质量。

快速开始

1. 安装

要求 Python 3.10+。

# 从 PyPI 安装
pip install movie-narrator

# 或者从源码安装
git clone https://github.com/zcbacxc/movie-narrator.git
cd movie-narrator
pip install -e .

可选附加项：

• [media]: 场景检测 (PySceneDetect)
• [ml]: WhisperX, FunASR 等本地 ML 依赖 (Python < 3.14)
• [full]: 包含所有依赖

2. 配置 LLM

默认使用本地 Ollama。你可以通过 ~/.movie-narrator/.env 文件配置其他提供商（如智谱 GLM、阿里百炼 Qwen 等）。

MN_LLM_BASE_URL=http://localhost:11434/v1
MN_LLM_MODEL=qwen2.5:7b
MN_DEFAULT_VOICE=zh-CN-YunxiNeural

3. 生成视频

只需一行命令即可开始创作：

# 基本用法：生成 60 秒热血搞笑风格的《飞驰人生》解说
mn create --movie "飞驰人生" --style "热血搞笑" --duration 60

# 高级用法：指定竖屏格式和特定语音
mn create --movie "飞驰人生" --voice "zh-CN-XiaoxiaoNeural" --format "9:16"

# 模仿爆款风格
mn imitate --reference viral_ref.mp4 --movie "飞驰人生"

输出文件结构

执行完成后，你将获得以下文件：

适用场景

• 短视频创作者：快速批量生产电影解说、剧情回顾类短视频。
• 影视营销：为电影制作多语言、多风格的宣传切片。
• 个人娱乐：将自己喜欢的电影片段重新剪辑并配上有趣的解说。
• 教育/研究：自动化生成带字幕和多语言翻译的教学视频素材。