Podcli

开源 AI 播客剪辑工具。
将长篇节目制作成带有人脸追踪和内嵌字幕的短片段。可通过命令行、Web 工作室或编码 Agent 操作。

podcli.com · 文档 · 安装 · MCP

_{▶ 在 X 上开启声音观看}

podcli process episode.mp4

只需这一条命令，就能转录节目、挑选值得剪辑的精彩片段、裁剪画面以跟随发言者，并嵌入字幕。转录和渲染都在你的设备上运行。只有在使用 AI 片段评分时，才会按需向 Claude 或 Codex 发起网络请求。

安装

无需任何前置条件。安装程序会获取一个独立运行的二进制文件；首次运行时，它会将所需的 Python、Node、FFmpeg、whisper.cpp 和模型安装到一个受管理的文件夹中。

macOS 和 Linux

curl -fsSL https://podcli.com/install.sh | sh

Windows（PowerShell）

irm https://podcli.com/install.ps1 | iex

支持 macOS（Apple Silicon）、Linux（x64 和 arm64）及 Windows（x64）。Intel Mac 支持正在开发中。

快速开始

podcli                       # interactive menu, opens the web studio
podcli process episode.mp4   # transcribe, pick moments, render clips
podcli multicam ~/ep12       # sync every camera and mic, cut to the speaker, render the episode

片段会保存在运行命令所在目录下的 podcli-clips/ 中，因此每个节目都有各自的渲染文件。其他内容（知识、预设、资源、片段历史记录、缓存）则统一存放在一个受管理的文件夹中，可在不同目录间使用。设置 PODCLI_OUTPUT 可将渲染文件输出到固定位置。

你能获得什么

短视频片段

• 9:16、16:9 或 1:1 画幅，字幕大小适配每种画布
• 面部跟踪会跟随说话者，并支持分屏布局
• 多段剪辑会去除语气词、长时间停顿和离题内容
• 四种字幕样式：branded、hormozi、karaoke、subtle
• 可重复使用的素材库提供 Logo、片头、片尾和背景音乐
• 音频已进行响度标准化，并支持使用 VideoToolbox、NVENC 和 VAAPI 进行硬件编码，也可回退到 CPU 编码

剪辑完整节目

• 多机位剪辑：指定一个包含摄像机和麦克风文件的文件夹，确认每个文件对应的人物，podcli 就会根据音频同步文件，并校正设备间的时钟漂移
• 自动切换摄像机画面，跟随当前说话者；多人同时说话时切换到广角镜头，嘉宾回答时则保持嘉宾画面
• 也支持远程录制节目：每个人的单独文件会合成为分屏画面，单个画廊录制文件则会拆分成每个画面格对应的单独摄像机画面。提问时保留分屏，嘉宾长时间回答时切换到全屏
• 将节目渲染为 MP4，并为每个人输出一个 WAV 文件。录音棚拍摄的节目也可以导出为 Premiere 或 Final Cut 时间线，并引用原始文件
• 可通过录音棚（多机位剪辑）、CLI（podcli multicam <folder>）或 Agent（manage_multicam）执行相同的剪辑。重新运行会复用同步结果和剪辑内容，因此只会重新执行你更改的步骤
• 使用 podcli Pro，可在云端编辑器中调整剪辑：podcli multicam <folder> --cloud 会发送小型预览和转录文本（摄像机文件仍保留在你的电脑上），而 --pull 会渲染你在那里制作的剪辑

寻找精彩片段

• 使用 Whisper 转录并区分说话者，也可导入 .txt、.srt 或 .vtt 格式的自有转录文本
• 可选择 AssemblyAI 作为替代引擎，也可使用 yt-dlp 直接从 URL 获取节目
• 根据你的知识库为片段评分，并与节目数据库核对，避免再次推荐你已发布的内容
• 通过音频能量和笑声检测生成精彩片段集锦

位于 localhost:3847 的录音棚

• 媒体库、节目工作区、多机位剪辑、单个片段详情、精彩片段、缩略图、内容、分析、素材、知识库、配置、集成和 MCP 设置
• 使用 ⌘K 命令面板，在页面、片段和素材间快速操作
• 标题、描述、标签和话题标签；可根据你自己的指导重新生成任意部分
• 缩略图工作室支持 16:9 和 9:16，并可设置画面和文字
• 转录文本修正会应用到每次渲染中

发布内容

• 提供 30 个 MCP 工具，让 Agent 能通过对话完成转录、评分、渲染和发布
• 支持发布到 YouTube，并提供效果分析，查看哪些片段表现出色
• 可导出为 DaVinci Resolve 使用的 FCPXML，以便手动完成剪辑
• 提供预设、带重复检测的片段历史记录，以及转录缓存

为什么选择 podcli

如果你正在比较 podcli 和云端剪辑工具，区别如下：

• 在本地运行。默认情况下，转录和渲染都在你的设备上完成，因此节目不会离开你的设备。只有可选的云端引擎（AssemblyAI）和发布到 YouTube 会将内容发送出去。
• 在 AGPL-3.0 许可下免费开源。导出次数不限、质量完整且无水印。
• 原生支持 Agent。30 个 MCP 工具让 Claude Code 或 Codex 能够驱动从转录到发布的完整流程。
• 知识库会让标题、字幕和描述符合你节目的风格，并避免引擎再次推荐你已发布的内容。
• 可交接到 DaVinci Resolve。想自行完成剪辑时，可将任意片段导出为 FCPXML。

通过 Agent 使用

podcli 是一个 MCP 服务，因此 Agent 可以通过对话完成转录、推荐片段和渲染。

podcli mcp install    # registers it with Claude Code and Codex, whichever CLI is on PATH

Claude Desktop 和 Codex 的设置说明见 MCP 文档。

内容工作流

PodStack 随附 podcli，提供一组 Claude Code 斜杠命令。它们可以将文字稿转化为可直接发布的内容包：评分后的精彩片段、标题、描述、缩略图简介、品牌审核和发布清单。

/produce-shorts

这些命令位于 .claude/commands/。 CLAUDE.md 介绍了每条命令。

文档

指南	内容
入门	安装、制作首期内容、完整流程
工作室	Web UI：媒体库、单集、内容、精彩片段
CLI	命令、标志、预设、素材
MCP 服务	Agent 设置和可用工具
字幕和格式	样式、宽高比、裁剪
配置	环境变量、配置档案、文字稿格式

文档在 nmbrthirteen/podcli-docs 上开源。

贡献

开发环境设置和约定请参阅 CONTRIBUTING.md，发布流程请参阅 RELEASE.md。

致谢

内容工作流由 PodStack 提供支持，灵感来自 Garry Tan 的 gstack。

许可证

AGPL-3.0。请参阅 LICENSE。

需要不受 AGPL 条款约束地使用 podcli？可申请商业许可证。请发送邮件至 [email protected]，并用一句话说明你的使用场景。