Community编程与开发github.com

moathalherani/arabic-keyword-captions

为阿拉伯语和英语口语视频制作简短关键词字幕(从SRT或VTT转录文件生成),每条字幕包含一个高亮词,支持拉丁数字和正确的从右到左渲染,并使用ffmpeg烧录到视频中。适用于需要字幕、标题、或视频翻译的场景。

arabic-keyword-captions 是什么?

这个AI技能专为需要为阿拉伯语和英语口语视频生成简洁关键词字幕的开发者或内容创作者设计。它从SRT或VTT转录文件生成2-4个词长的字幕,每条字幕突出一个颜色高亮的关键词(如产品名、数字或关键术语),并自动处理从右到左(RTL)文本渲染和拉丁数字。技能基于命令行工具(通过npx运行)实现,支持自定义字体、字号、高亮颜色和字幕窗口宽度,并可选择保留填充词(如“يعني”)。生成的ASS字幕文件随后可通过ffmpeg烧录到视频中,推荐放置于视频下三分之一区域以避免遮挡重要内容。该技能在Claude Code、Cursor、Codex等AI代理环境中使用,提供高效的字幕制作工作流,尤其适合社交媒体短视频(如Reels)的优化。工具默认去除填充词,优先高亮数字和英文产品名,并支持手动编辑以确保单个字幕不拆分专有名词(如“BYD Seal”)。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/moathalherani/arabic-creator-kit/tree/main/skills/arabic-keyword-captions

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

阿拉伯语关键词字幕

手机上连续全句字幕难以阅读。简短字幕(2到4个词)搭配一个彩色关键词,能让观众的视线始终停留在视频上。

步骤

  1. 获取转录文件(SRT或VTT格式)。 从Whisper、CapCut、Premiere、DaVinci、Descript或YouTube Studio获取。先修正名称和品牌的拼写。

  2. 生成字幕

    npx arabic-captions talk.srt -w 3 -f ass --font "Changa" --size 84 --highlight "#7FB069" -o talk.ass
    
    • 对于语速快的说话者使用-w 2,语速慢的使用-w 4。
    • 高亮功能优先选取数字,其次是英文产品名,最后是最有意义的单词。
    • 填充词如“يعني”和“اممم”会被丢弃;使用--keep-fillers保留它们。
  3. 烧录字幕

    ffmpeg -i talk.mp4 -vf ass=talk.ass -c:a copy talk.captioned.mp4
    

    首先在机器上安装字体。对于1080×1920的视频,默认位置位于下三分之一处,在平台UI上方。

  4. 检查三个关键点: 钩子(开场吸引点)、任何含有英文单词的行、以及任何数字。阿拉伯语应自右向左阅读,英文单词位置正确。

选择高亮颜色

从视频本身(如植物、汽车、墙壁)挑选一种颜色,让字幕感觉是画面的一部分。保持文字白色并带有深色轮廓。仅在警告或错误时使用红色,在解决方案或结果时使用绿色。

手动编辑时的注意事项

  • 每条字幕只表达一个想法;尽量避免将“BYD Seal”这样的名称拆分到两条字幕中。
  • 数字使用0-9;英文单词用英文字母书写。
  • 字幕不得遮挡说话者的面部或展示的产品。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能