Skip to content
Back to search

video-podcast-maker

Topic → 4K narrated video for coding agents. v5.3.0: local TTS (edge free + azure, no external engine), manifest-based Asset Engine, Remotion composition, cost-gated AI generation, Bilibili/YouTube/Xiaohongshu/Douyin/WeChat Channels

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agents365-ai--video-podcast-maker/badge.svg)](/listings/agents365-ai--video-podcast-maker)

HTML

<a href="/listings/agents365-ai--video-podcast-maker"><img src="/api/listings/agents365-ai--video-podcast-maker/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**1. Install:** with the skills CLI, pointing at the full skill:

npx skills add Agents365-ai/video-podcast-maker/skills/video-podcast-maker -g

Drop the `/skills/video-podcast-maker` suffix to install all three variants (full, `-lite`, `-nano`), or clone this repo instead. Paths below are written from the repo root; under a skills CLI install the same files live in the agent's `${SKILL_DIR}`.

**2. Set up** — Python 3.8+, Node.js 18+, FFmpeg, and a Remotion project:

brew install ffmpeg node python3          # macOS (Ubuntu: sudo apt install ffmpeg nodejs python3)
pip install -r skills/video-podcast-maker/requirements.txt
npx create-video@latest my-video-project   # or reuse an existing Remotion project
cd my-video-project && npm i

> **One-time cost:** a fresh Remotion project downloads ~2.2 GB of npm packages > plus a ~90 MB Chrome headless shell. **Prefer reusing an existing Remotion > project** (with `node_modules/` already installed) for your next video — the > heavy install happens once per project, not per video. Lottie animations are > optional (`@remotion/lottie` + `lottie-web`); install them per project only if > you use `LottieAnimation`.

**3. Configure** — set `TTS_BACKEND` plus its API keys (see [TTS Backends](#tts-backends) and [Environment Variables](#environment-variables)).

**4. Tell your agent:**

> "Create a video podcast about [your topic]"

The agent runs the whole workflow (research → script → TTS → Remotion composition → Studio review → 4K render + BGM). Preview and iterate in Remotion Studio (`npx remotion studio src/remotion/index.ts`); the agent waits for your explicit "render 4K" confirmation before the final render.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 218 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Video Podcast Maker
  2. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
  3. [![GitHub stars](https://img.shields.io/github/stars/Agents365-ai/video-podcast-maker?style=flat&logo=github)](https://github.com/Agents365-ai/video-podcast-maker/stargazers)
  4. [![GitHub forks](https://img.shields.io/github/forks/Agents365-ai/video-podcast-maker?style=flat&logo=github)](https://github.com/Agents365-ai/video-podcast-maker/network/members)
  5. [![Latest Release](https://img.shields.io/github/v/release/Agents365-ai/video-podcast-maker?logo=github)](https://github.com/Agents365-ai/video-podcast-maker/releases/latest)
  6. [![Last Commit](https://img.shields.io/github/last-commit/Agents365-ai/video-podcast-maker?logo=github)](https://github.com/Agents365-ai/video-podcast-maker/commits/main)
  7. [![SkillsMP](https://img.shields.io/badge/SkillsMP-listed-1f6feb)](https://skillsmp.com)
  8. [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-2ea44f)](https://agentskills.io)
  9. [中文文档](README_CN.md)
  10. Automated pipeline to create professional video podcasts from a topic. **Supports Bilibili, YouTube, Xiaohongshu, Douyin, and WeChat Channels** with multi-language output (zh-CN, en-US). Combines research, script generation, local TTS (edge free, plus azure), Remotion rendering, and FFmpeg mixing. Current release: **v5.3.0** — see [CHANGELOG.md](CHANGELOG.md) for version history.
  11. **Works with:** [Claude Code](https://claude.ai/code) · [OpenClaw](https://openclaw.ai/) · [OpenCode](https://opencode.ai/) · [Codex](https://openai.com/index/introducing-codex/) · [Pi](https://github.com/earendil-works/pi-coding-agent) — any coding agent that supports SKILL.md
  12. **Publish to:** Bilibili · YouTube · Xiaohongshu · Douyin · WeChat Channels
  13. > **No coding required!** Just describe your topic in plain language — the coding agent guides you through each step interactively. You make creative decisions, the agent handles all the technical details.
  14. > **Note:** This project is still under active development and may not be fully mature yet. Your feedback is greatly appreciated — feel free to [open an issue](https://github.com/Agents365-ai/video-podcast-maker/issues).
  15. ## Features
  16. - **Topic → 4K video** - research, narration script, TTS audio, Remotion composition, 4K render + BGM in one pipeline
  17. - **Local TTS backends** - Edge (free, no key) and Azure — synthesized in-house, no external component skill required
  18. - **Asset engine** - per-video manifest with license provenance; producers are user files, assetseeker stock, imagencn AI stills, videogencn AI B-roll, and Hyperframes overlays — paid generation always asks first
  19. - **4K output + Remotion-native subtitles** - 3840×2160; SRT rendered in React at 4K (legacy FFmpeg burn-in available)
  20. - **Design learning** - extract style profiles from reference videos/images; auto-applied when topics match
  21. - **Vertical shorts** - 9:16 highlight clips generated from long-form sections
  22. - **Multi-platform & multi-language** - Bilibili / YouTube / Xiaohongshu / Douyin / WeChat Channels × zh-CN / en-US, with per-platform publish info
  23. - **Pronunciation control** - global + per-project phoneme dictionaries for Chinese polyphones
  24. ## Quick Start
  25. **1. Install:** with the skills CLI, pointing at the full skill:
  26. ```bash
  27. npx skills add Agents365-ai/video-podcast-maker/skills/video-podcast-maker -g
  28. ```
  29. Drop the `/skills/video-podcast-maker` suffix to install all three variants (full, `-lite`, `-nano`), or clone this repo instead. Paths below are written from the repo root; under a skills CLI install the same files live in the agent's `${SKILL_DIR}`.
  30. **2. Set up** — Python 3.8+, Node.js 18+, FFmpeg, and a Remotion project:
  31. ```bash
  32. brew install ffmpeg node python3 # macOS (Ubuntu: sudo apt install ffmpeg nodejs python3)
  33. pip install -r skills/video-podcast-maker/requirements.txt
  34. npx create-video@latest my-video-project # or reuse an existing Remotion project
  35. cd my-video-project && npm i
  36. ```
  37. > **One-time cost:** a fresh Remotion project downloads ~2.2 GB of npm packages
  38. > plus a ~90 MB Chrome headless shell. **Prefer reusing an existing Remotion
  39. > project** (with `node_modules/` already installed) for your next video — the
  40. > heavy install happens once per project, not per video. Lottie animations are
  41. > optional (`@remotion/lottie` + `lottie-web`); install them per project only if
  42. > you use `LottieAnimation`.
  43. **3. Configure** — set `TTS_BACKEND` plus its API keys (see [TTS Backends](#tts-backends) and [Environment Variables](#environment-variables)).
  44. **4. Tell your agent:**
  45. > "Create a video podcast about [your topic]"
  46. The agent runs the whole workflow (research → script → TTS → Remotion composition → Studio review → 4K render + BGM). Preview and iterate in Remotion Studio (`npx remotion studio src/remotion/index.ts`); the agent waits for your explicit "render 4K" confirmation before the final render.
  47. ## ⚠️ For the human reading this (not the AI): manually polish `podcast.txt`, repeatedly
  48. > **This section is for you, the human — not the agent.** Every downstream step — TTS narration, subtitles, section transitions, animation timing, final cut — **is derived from this single `podcast.txt`**. A weak script renders into 4K garbage. No amount of polish downstream saves it.
  49. >
  50. > The AI-generated draft is a starting point, nothing more. Do these yourself — **don't hand them off to the AI**:
  51. >
  52. > 1. **Mentally read it as the narrator.** Treat each sentence as one breath — if a line forces you to "catch your breath" or backtrack to parse, fix it. Where you stumble silently is where TTS stumbles audibly.
  53. > 2. **Revise at least three times.**
  54. > - Pass 1: typos, awkward phrasing, tongue-twisters
  55. > - Pass 2: cut filler, cut throat-clearing intros ("So today we're going to talk about…"), cut redundancy
  56. > - Pass 3: tune rhythm — where to pause, where to break a long sentence, which word carries the stress
  57. > 3. **Read each `[SECTION:xxx]` block end-to-end.** Confirm each section opens with a hook and lands a clean transition into the next — not a bullet-point dump.
  58. > 4. **Audit numbers, proper nouns, and English terms separately.** ~90% of TTS mispronunciations live here. If pronunciation is wrong, add it to `phonemes.json`; if it just sounds awkward, rewrite it.
  59. > 5. **Know your length budget.** Estimate **~280 zh-CN chars/min** or **~150 en words/min**. A 5–10 min video means ~1400–2800 chars / 750–1500 words. Don't pad to fill time.
  60. >
  61. > **The only acceptance test:** read through it once in your head — does any line make you wince? If yes, don't move on to Step 7 (TTS) yet. Otherwise you're just rendering 4K of something even you don't want to hear.
  62. ## Workflow
  63. ![Pipeline](images/pipeline.png)
  64. ## Related Skills
  65. **Variants in this repo** (`skills/`):
  66. - **video-podcast-maker** — the full production pipeline (this README's subject)
  67. - **[video-podcast-maker-lite](skills/video-podcast-maker-lite/)** — minimal personal pipeline: Azure SSML TTS + Remotion, no bundled templates
  68. - **[video-podcast-maker-nano](skills/video-podcast-maker-nano/)** — tool-agnostic, logic-only pipeline (any TTS backend, any video tool); autonomous by default, oversight configured per project
  69. **External skills:**
  70. - **[remotion-best-practices](https://github.com/remotion-dev/skills)** - recommended; core Remotion patterns and guidelines (built-in minimum rules if absent)
  71. - **[assetseeker](https://github.com/Agents365-ai/assetSeeker)** - optional; license-vetted stock photos/video/BGM/SFX/icons/fonts
  72. - **[imagencn](https://github.com/Agents365-ai/imagenCN)** - optional; AI stills and thumbnails (paid APIs)
  73. - **[videogencn](https://github.com/Agents365-ai/videogenCN)** - optional; AI video clips for B-roll (paid APIs)
  74. - **[Hyperframes](https://github.com/heygen-com/hyperframes)** - optional; transparent overlay animations (Node 22+)
  75. ## Requirements
  76. | Software | Version | Purpose |
  77. | ---------- | --------- | --------- |
  78. | **macOS / Linux** | - | Tested on macOS, Linux compatible |
  79. | **Python** | 3.8+ | TTS script, automation |
  80. | **Node.js** | 18+ | Remotion video rendering |
  81. | **FFmpeg** | 4.0+ | Audio/video processing |
  82. > **Installed through the skills CLI?** SKILL.md, scripts, and templates then live under the agent's `${SKILL_DIR}`; paths in this README are written from the repo-root perspective, which is what a clone gives you.
  83. ### TTS Backends (local)
  84. TTS synthesis is in-house — no external component skill required. Set `TTS_BACKEND` to a platform id; only the active platform's env vars are needed:
  85. | `TTS_BACKEND` | Provider | Required env vars | Get Key |
  86. | --------------- | ---------- | ------------------- | --------- |
  87. | `edge` (default) | Microsoft Edge TTS | *(none — free)* | — |
  88. | `azure` | Microsoft Azure Speech | `AZURE_SPEECH_KEY`, `AZURE_SPEECH_REGION` (default `eastasia`) | [Azure Portal](https://portal.azure.com/) |
  89. > **Want more platforms?** The former [ttscn](https://github.com/Agents365-ai/ttsCN) component skill (cosyvoice, doubao, tencent, baidu, minimax, xunfei, elevenlabs, openai, google) is no longer a dependency. Install it separately and call it directly if you need those.
  90. ### Environment Variables
  91. Add to `~/.zshrc` or `~/.bashrc`:
  92. ```bash
  93. export TTS_BACKEND="edge" # edge (default) / azure
  94. export TTS_VOICE="zh-CN-XiaoxiaoNeural" # optional; unset = backend default
  95. export TTS_RATE="+5%" # optional; also settable in user_prefs.json (global.tts.rate)
  96. export TTS_STYLE="gentle" # optional; azure only
  97. export AZURE_SPEECH_KEY="..." # keys for azure (see table above)
  98. export AZURE_SPEECH_REGION="eastasia" # azure speech region
  99. export GEMINI_API_KEY="..." # optional: AI thumbnails (imagencn)
  100. export DASHSCOPE_API_KEY="..." # optional: AI thumbnails (imagencn; ark/hunyuan/zhipu/step also work)
  101. ```
  102. Then reload: `source ~/.zshrc`
  103. ## Configuration
  104. Mutable user-level files live in `~/.video-podcast-maker/` (shared across projects, safe from skill updates); the rest live in the skill root (`skills/video-podcast-maker/` in this repo, `${SKILL_DIR}` when installed):
  105. | File | Location | Purpose |
  106. | ------ | -------- | --------- |
  107. | `phonemes.json` | `~/.video-podcast-maker/` | Global polyphone dictionary; auto-created from the bundled template; per-project overrides in `videos/{name}/phonemes.json` |
  108. | `user_prefs.json` | `~/.video-podcast-maker/` | Your preferences (TTS, BGM, platform, visual overrides, style profiles); auto-created from template |
  109. | `user_prefs.template.json` / `phonemes.template.json` | Skill root | Default templates — sources for the user-level copies |
  110. | `prefs_schema.json` | Skill root | JSON Schema for preference validation |
  111. | `tsconfig.json` | Skill root | TypeScript config for Remotion templates |
  112. **Output structure** — every video renders into its own `videos/{name}/` directory:
  113. ```
  114. videos/{video-name}/
  115. ├── topic_definition.md # Topic direction
  116. ├── topic_research.md # Research notes
  117. ├── podcast.txt # Narration script
  118. ├── phonemes.json # (Optional) pronunciation overrides
  119. ├── assets/manifest.json # Asset registry (role / source / license)
  120. ├── podcast_audio.wav # TTS audio
  121. ├── podcast_audio.srt # Subtitles
  122. ├── timing.json # Section timing (drives animation sync)
  123. ├── thumbnail_*.png # Video thumbnails
  124. ├── publish_info.md # Title, tags, description
  125. ├── output.mp4 # Raw 4K render
  126. ├── video_with_bgm.mp4 # With BGM
  127. ├── bgm.mp3 # Background music
  128. ├── final_video.mp4 # Final output
  129. └── shorts/ # (Optional) 9:16 vertical shorts
  130. ```
  131. **Background music:** bundled tracks live in `skills/video-podcast-maker/assets/` — `perfect-beauty-191271.mp3` (upbeat) and `snow-stevekaldes-piano-397491.mp3` (calm piano). Per-platform behavior (thumbnails, chapters, CTA, publish formats) is documented in the skill's `references/platform-matrix.md`.
  132. ## ❤️ Support
  133. If this project helps you, consider supporting the author:
  134. <table>
  135. <tr>
  136. <td align="center">
  137. <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/wechat-pay.png" width="180" alt="WeChat Pay">
  138. <br>
  139. <b>WeChat Pay</b>
  140. </td>
  141. <td align="center">
  142. <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/alipay.png" width="180" alt="Alipay">
  143. <br>
  144. <b>Alipay</b>
  145. </td>
  146. <td align="center">
  147. <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/qrcode/buymeacoffee.png" width="180" alt="Buy Me a Coffee">
  148. <br>
  149. <b>Buy Me a Coffee</b>
  150. </td>
  151. <td align="center">
  152. <img src="https://raw.githubusercontent.com/Agents365-ai/images_payment/main/awarding/award.gif" width="180" alt="Give a Reward">
  153. <br>
  154. <b>Give a Reward</b>
  155. </td>
  156. </tr>
  157. </table>
  158. ## 👤 Author
  159. **Agents365-ai**
  160. - Bilibili: <https://space.bilibili.com/441831884>
  161. - GitHub: <https://github.com/Agents365-ai>
  162. ## 📄 License
  163. [MIT](LICENSE) — Permission is hereby granted, free of charge, to any person obtaining a copy of this software.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.