关于 remotion-render-config
remotion-render-config 是为 Remotion 视频渲染生成配置文档的技能,面向需要设定导出参数的创作者和开发者。它聚焦格式、编码、画质、分辨率及平台预设,不负责合成内容或场景实现。
主要功能
- 01生成渲染配置文档
- 02配置格式与视频、音频编码
- 03设置画质、压缩和分辨率
- 04提供平台专用参数预设
- 05生成渲染命令与配置文件示例
适用场景
- 01为 YouTube 视频设置导出参数
- 02为社交平台配置视频规格
- 03制作低画质预览或高质量存档
- 04输出图像序列供后期处理
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ ncklrs/ startup-os-skills --skill remotion-render-config安装后在 Claude Code 中输入/remotion-render-config确认已加载。
详细介绍
Remotion 渲染配置
生成渲染配置文档,用于定义 Remotion 视频渲染的输出设置、编解码器参数、格式选项和质量设置。本技能仅关注渲染/导出配置。
本技能的功能
生成以下内容的渲染配置:
- 输出格式 — MP4、WebM、ProRes 等。
- 编解码器设置 — H.264、H.265、VP9 参数
- 质量设置 — CRF、比特率、压缩级别
- 分辨率 — 输出尺寸和缩放
- 平台优化 — YouTube、Twitter、Instagram 预设
范围界定
范围内:
- 渲染命令配置
- 编解码器和格式选择
- 质量和压缩设置
- 特定平台的优化
- 输出文件参数
范围外:
- 合成实现(使用
/remotion-composition) - 场景逻辑(使用
/remotion-component-gen) - 动画参数(使用
/remotion-animation) - 资源管理(使用
/remotion-asset-coordinator)
输入/输出格式
输入格式:目标平台/质量要求
接受渲染目标规格:
自然语言:
Render for YouTube at high quality with H.264 codec
结构化格式:
## Render Requirements
**Target Platform:** YouTube
**Quality Level:** High
**Format:** MP4 (H.264)
**Resolution:** 1920x1080
**Frame Rate:** 30 fps
**Additional:** Upload-ready, optimized file size
输出格式:RENDER_CONFIG.md
生成完整的渲染配置文档:
# Render Configuration: ProductDemo
## Status
✅ Render settings defined
⏳ Ready for video render
## Render Command
```bash
npx remotion render \
src/index.tsx \
ProductDemo \
output.mp4 \
--codec=h264 \
--crf=18 \
--pixel-format=yuv420p \
--audio-codec=aac \
--audio-bitrate=320k
配置详情
输出格式
- 容器: MP4
- 视频编解码器: H.264(x264)
- 音频编解码器: AAC
- 像素格式: yuv420p(兼容性最佳)
质量设置
- CRF: 18(高质量,约 15-20 MB/分钟)
- 音频比特率: 320 kbps(高质量)
- 预设: medium(速度与质量均衡)
分辨率
- 输出: 1920x1080(16:9)
- 帧率: 30 fps
- 时长: 30 秒(900 帧)
平台:YouTube
针对 YouTube 上传进行优化:
- ✅ H.264 编解码器(广泛支持)
- ✅ yuv420p 像素格式(必需)
- ✅ AAC 音频(推荐)
- ✅ CRF 18(高质量,文件大小适中)
- ✅ 兼容元数据
**预计文件大小:**约 45-60 MB
其他渲染选项
Web 交付(文件更小)
npx remotion render \
src/index.tsx \
ProductDemo \
output.mp4 \
--codec=h264 \
--crf=23 \
--audio-bitrate=192k
文件大小:约 25-35 MB
最高质量(归档)
npx remotion render \
src/index.tsx \
ProductDemo \
output.mp4 \
--codec=h264 \
--crf=15 \
--audio-bitrate=320k \
--preset=slower
文件大小:约 80-100 MB
快速预览渲染
npx remotion render \
src/index.tsx \
ProductDemo \
preview.mp4 \
--crf=28 \
--preset=ultrafast
文件大小:约 15-20 MB
渲染工作流
-
测试渲染(前 3 秒):
npx remotion render src/index.tsx ProductDemo test.mp4 --frames=0-90 -
完整渲染并显示进度:
npx remotion render src/index.tsx ProductDemo output.mp4 --codec=h264 --crf=18 -
验证输出:
- 检查文件大小
- 使用视频播放器播放
- 验证音画同步
- 检查画质
-
上传到平台(YouTube 等)
后续步骤
- 运行测试渲染,验证时长和画质
- 如果文件过大或过小,调整 CRF
- 准备就绪后进行完整渲染
- 上传到目标平台
故障排查
文件过大:
- 提高 CRF(网页交付可设为 23-28)
- 降低音频比特率(192k 或 128k)
画质问题:
- 降低 CRF(更高画质可设为 15-17)
- 使用更慢的预设(slow、slower)
渲染缓慢:
- 使用更快的预设(fast、veryfast)
- 测试时暂时降低分辨率
检查清单
- 已选择编解码器
- 已定义质量设置
- 已针对平台优化
- 已生成渲染命令
- 已完成测试渲染
- 已完成完整渲染
- 已验证输出
## Codec Reference
### H.264 (Most Compatible)
Best for: YouTube, web delivery, social media
```bash
--codec=h264
--crf=18 # Quality (lower = better, 15-28 typical)
--pixel-format=yuv420p
--audio-codec=aac
--audio-bitrate=320k
质量级别:
- CRF 15-17:极佳(文件较大)
- CRF 18-20:高(推荐)
- CRF 21-23:良好(网页交付)
- CRF 24-28:可接受(预览/草稿)
H.265(HEVC)— 更佳压缩效果
适用于:现代平台、更小的文件、4K 视频
--codec=h265
--crf=23
--pixel-format=yuv420p10le
**注意:**并非所有平台都支持,但在相同画质下,文件可缩小约 50%
VP9(开源)
适用于:WebM 格式、网页交付、Chrome/Firefox
--codec=vp9
--crf=30
--pixel-format=yuv420p
ProRes(专业级)
适用于:视频剪辑、最高画质、无压缩
--codec=prores
--prores-profile=3 # HQ profile
**警告:**文件非常大(约 1-2 GB/分钟)
质量与文件大小参考
对于 30 秒、1080p、30fps 的视频:
| CRF | 质量 | 文件大小 | 用途 |
|---|---|---|---|
| 15 | 极佳 | 80-100 MB | 归档、编辑 |
| 18 | 高 | 45-60 MB | YouTube、高质量 |
| 21 | 良好 | 30-40 MB | Web、社交媒体 |
| 23 | 可接受 | 20-30 MB | Web 分发 |
| 28 | 预览 | 10-15 MB | 草稿、测试 |
平台专用预设
YouTube
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=18 \
--pixel-format=yuv420p \
--audio-codec=aac \
--audio-bitrate=320k
规格:
- 分辨率:1920x1080 或更高
- 帧率:24、25、30、48、50 或 60 fps
- 编码:H.264 或 H.265
- 音频:AAC-LC,320 kbps
Twitter/X
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=20 \
--audio-bitrate=192k
规格:
- 最长时长:2:20(140 秒)
- 最大文件大小:512 MB
- 分辨率:最高 1920x1200 或 1200x1920
Instagram Feed
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=20 \
--audio-bitrate=192k
规格:
- 最长时长:60 秒
- 分辨率:1080x1080(1:1)或 1080x1350(4:5)
- 帧率:30 fps
- 编码:H.264
Instagram Reels/Stories
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=20 \
--audio-bitrate=192k
规格:
- 分辨率:1080x1920(9:16)
- 最长时长:90 秒(Reels)、15 秒(Stories)
- 帧率:30 fps
TikTok
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=20 \
--audio-bitrate=192k
规格:
- 分辨率:1080x1920(9:16)
- 最长时长:10 分钟
- 最大文件大小:287.6 MB
- 帧率:30 或 60 fps
npx remotion render src/index.tsx VideoName output.mp4 \
--codec=h264 \
--crf=20 \
--audio-bitrate=192k
规格:
- 最大文件大小:5 GB
- 分辨率:256x144 至 4096x2304
- 帧率:10-60 fps
高级渲染选项
并发(加快渲染)
--concurrency=8 # Use 8 CPU cores
图像序列(用于后期处理)
--sequence
--image-format=png
输出 PNG 序列,可用于 After Effects、Premiere 等。
指定帧范围
--frames=30-90 # Render frames 30-90 only
缩放输出
--scale=0.5 # Render at 50% resolution (960x540)
适用于快速预览。
覆盖现有文件
--overwrite
自定义输出名称
npx remotion render src/index.tsx VideoName "output/final-video.mp4"
环境变量
# Number of CPU cores to use
export REMOTION_CONCURRENCY=8
# Disable browser sandbox (Docker)
export REMOTION_DISABLE_CHROMIUM_SANDBOX=true
# Set custom Chromium path
export REMOTION_CHROMIUM_PATH=/path/to/chromium
渲染配置文件
创建 remotion.config.ts:
import { Config } from "@remotion/cli/config";
Config.setCodec("h264");
Config.setCrf(18);
Config.setPixelFormat("yuv420p");
Config.setAudioBitrate("320k");
Config.setAudioCodec("aac");
Config.setConcurrency(8);
Config.setOverwriteOutput(true);
然后进行渲染:
npx remotion render
渲染脚本
添加到 package.json:
{
"scripts": {
"render:preview": "remotion render src/index.tsx VideoName preview.mp4 --crf=28 --preset=ultrafast",
"render:draft": "remotion render src/index.tsx VideoName draft.mp4 --crf=23",
"render:final": "remotion render src/index.tsx VideoName output.mp4 --codec=h264 --crf=18",
"render:youtube": "remotion render src/index.tsx VideoName youtube.mp4 --codec=h264 --crf=18 --audio-bitrate=320k"
}
}
用法:
npm run render:youtube
渲染性能提示
- 使用并发以利用所有 CPU 核心
- 渲染期间关闭其他应用程序
- 使用 SSD以加快文件 I/O
- 如果渲染过慢,降低合成复杂度
- 完整渲染前,先测试渲染较小的范围
- 如果需要透明度,请使用 image-format 属性
质量验证清单
渲染后:
- 文件可正常播放,没有错误
- 音频与视频同步
- 视觉质量符合预期
- 文件大小适合目标平台
- 没有明显的编码伪影
- 色彩显示正常
- 文字清晰可读
- 动画流畅
集成工作流
- 通过其他技能完成合成
- 使用此技能生成渲染配置 → RENDER_CONFIG.md
- 运行测试渲染(前几秒)
- 验证质量和时序
- 运行完整渲染
- 上传到目标平台
与其他技能集成
此技能是工作流中的最后一步:
remotion-render-config (this skill)
↓ outputs: RENDER_CONFIG.md
↓ used after: All implementation is complete
↓ produces: Final video file
适用于:
/remotion-scaffold— 渲染已完成的项目/remotion-composition— 渲染结构化合成/remotion-component-gen— 渲染已实现的场景/remotion-spec-translator— 将此步骤作为最后一步进行编排
此技能提供可用于生产的渲染配置,确保输出的高质量视频针对目标平台进行了优化。