mcpField
R
remotion-render-config

remotion-render-config

github.com/ncklrs创意与媒体53164 次安装35 周前更新
代码仓库

关于 remotion-render-config

remotion-render-config 是为 Remotion 视频渲染生成配置文档的技能,面向需要设定导出参数的创作者和开发者。它聚焦格式、编码、画质、分辨率及平台预设,不负责合成内容或场景实现。

主要功能

  1. 01生成渲染配置文档
  2. 02配置格式与视频、音频编码
  3. 03设置画质、压缩和分辨率
  4. 04提供平台专用参数预设
  5. 05生成渲染命令与配置文件示例

适用场景

  1. 01为 YouTube 视频设置导出参数
  2. 02为社交平台配置视频规格
  3. 03制作低画质预览或高质量存档
  4. 04输出图像序列供后期处理

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ncklrs/startup-os-skills --skill remotion-render-config

安装后在 Claude Code 中输入/remotion-render-config确认已加载。

详细介绍

Remotion 渲染配置

生成渲染配置文档,用于定义 Remotion 视频渲染的输出设置、编解码器参数、格式选项和质量设置。本技能仅关注渲染/导出配置。

本技能的功能

生成以下内容的渲染配置:

  1. 输出格式 — MP4、WebM、ProRes 等。
  2. 编解码器设置 — H.264、H.265、VP9 参数
  3. 质量设置 — CRF、比特率、压缩级别
  4. 分辨率 — 输出尺寸和缩放
  5. 平台优化 — 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

渲染工作流

  1. 测试渲染(前 3 秒):

    npx remotion render src/index.tsx ProductDemo test.mp4 --frames=0-90
    
  2. 完整渲染并显示进度:

    npx remotion render src/index.tsx ProductDemo output.mp4 --codec=h264 --crf=18
    
  3. 验证输出:

    • 检查文件大小
    • 使用视频播放器播放
    • 验证音画同步
    • 检查画质
  4. 上传到平台(YouTube 等)

后续步骤

  1. 运行测试渲染,验证时长和画质
  2. 如果文件过大或过小,调整 CRF
  3. 准备就绪后进行完整渲染
  4. 上传到目标平台

故障排查

文件过大:

  • 提高 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 MBYouTube、高质量
21良好30-40 MBWeb、社交媒体
23可接受20-30 MBWeb 分发
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
LinkedIn
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

渲染性能提示

  1. 使用并发以利用所有 CPU 核心
  2. 渲染期间关闭其他应用程序
  3. 使用 SSD以加快文件 I/O
  4. 如果渲染过慢,降低合成复杂度
  5. 完整渲染前,先测试渲染较小的范围
  6. 如果需要透明度,请使用 image-format 属性

质量验证清单

渲染后:

  • 文件可正常播放,没有错误
  • 音频与视频同步
  • 视觉质量符合预期
  • 文件大小适合目标平台
  • 没有明显的编码伪影
  • 色彩显示正常
  • 文字清晰可读
  • 动画流畅

集成工作流

  1. 通过其他技能完成合成
  2. 使用此技能生成渲染配置 → RENDER_CONFIG.md
  3. 运行测试渲染(前几秒)
  4. 验证质量和时序
  5. 运行完整渲染
  6. 上传到目标平台

与其他技能集成

此技能是工作流中的最后一步:

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 — 将此步骤作为最后一步进行编排

此技能提供可用于生产的渲染配置,确保输出的高质量视频针对目标平台进行了优化。

评论

支持 Markdown