Skillppx logo

Ffmpeg Chinese Subtitle

使用 Pillow 绘制中文字幕，避免 ffmpeg 编码问题，实现稳定字幕输出。

已扫描
适合谁
视频剪辑初学者、需要批量添加中文字幕的创作者
不适合谁
无需中文字幕的用户、不熟悉 Python 的普通用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @systiger/ffmpeg-chinese-subtitle
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

ffmpeg Chinese Subtitle

Windows 上使用 ffmpeg 正确生成中文字幕的解决方案。

问题背景

在 Windows 上使用 ffmpeg 的 drawtext、subtitles、ass 滤镜处理中文字幕时，会遇到以下问题：

错误码原因
返回码 -22 (EINVAL)字体路径转义问题
字幕不显示中文编码被截断
乱码字符集不匹配

解决方案

核心思路：用 Pillow 在图片上绘制字幕，ffmpeg 只负责图片转视频。

方案对比

方案状态原因
drawtext=text='中文'❌ 失败命令行参数截断
subtitles='中文.srt'❌ 失败路径编码问题
ass='中文.ass'❌ 失败同上
Pillow 绘制 + ffmpeg✅ 成功Python 原生支持 Unicode

快速使用

from ffmpeg_subtitle import add_subtitle_to_image

# 在图片上添加字幕
add_subtitle_to_image(
    image_path="input.png",
    subtitle_text="这是中文字幕",
    output_path="output.png",
    font_size=24,
    y_offset=50
)

参数说明

参数默认值说明
image_path-输入图片路径
subtitle_text-字幕文本
output_path-输出图片路径
font_size24字体大小
y_offset50距底部的偏移量（像素）
font_color(255,255,255)字体颜色 RGB
shadow_color(0,0,0)阴影颜色 RGB

依赖

Pillow>=10.0.0

字体

默认使用 Windows 系统字体：

  • 主字体：C:/Windows/Fonts/msyh.ttc（微软雅黑）
  • 备用字体：C:/Windows/Fonts/simhei.ttf（黑体）

触发词

ffmpeg字幕、中文字幕、视频字幕、字幕烧录

文件结构

ffmpeg-chinese-subtitle/
├── SKILL.md           # 技能说明文档
├── README.md          # 详细使用指南
├── ffmpeg_subtitle.py # 核心模块
├── example.py         # 完整示例
└── package.json       # 包信息

License

MIT

Author

systiger

S
@systiger

已收录 1 个 Skill

相关推荐