【源码 · 视界】视频添加水印

概述

视频文字水印

适用场景：除常规创作外，本技能特别适合把课程、训练营、知识付费直播回放整理为可分发到抖音 / B站 / 视频号的短视频，将长内容转化为可引流的短内容矩阵，为你的自有课程或社群导流。

本技能源自「源码·视界」团队的实战流程——他们用同一套方法把 AI 直播课切片成短视频、持续为自有训练营导流，已沉淀 多套完整课程的拆分经验。

概述

给视频叠加带样式的文字水印。水印可以是单个角标、多个角标同时存在，也可以是沿画面漂移的动态水印。技能内置一个确定性的 scripts/watermark.py 引擎（Pillow + ffmpeg），一条命令即可产出成片。ffmpeg 会在首次使用时自动下载并缓存（经 imageio-ffmpeg 拉取一份静态版到用户目录；如该包未安装，脚本会尝试 pip install imageio-ffmpeg），买家无需提前安装 ffmpeg（首次运行需联网）。

使用场景

在以下情况使用本技能：

• 给一个或多个视频加“课程水印”“品牌水印”“署名水印”“防搬运水印”
• 自定义水印的文字、字体、字号、颜色、透明度、位置或运动方式
• 添加静态角标，或会移动（动态）的水印

本技能仅处理文字水印，不适用于图片 / Logo 水印（PNG 图标叠加请走其它方式）。

工作流程

脚本运行前会自动检查依赖环境，缺失时会向 stderr 输出明确的安装指引。

1. 收集输入视频路径。向用户索取源视频的绝对路径。若用户给了多个视频，则对每个视频各跑一次脚本（Bash 里用 for 循环即可）。
2. 收集水印选项——或采用合理默认值：
   • --text：水印文字内容（默认 源码·视界）
   • --font：yahei（微软雅黑）| hei（黑体）| song（宋体）| kai（楷体），或直接传 .ttf/.ttc 字体文件路径（默认 yahei）
   • --size：正文字号(px)（默认 50）
   • --emph-char + --emph-size：可选，将某个字符渲染得更大（例如 · 设为 72）；设置后该字符按强调字号渲染，并与正文字做视觉垂直居中
   • --color：任意 PIL 颜色名（white/red/…）或 #rrggbb（默认 white）
   • --opacity：0~1 或 0~100（默认 0.45）
   • --shadow：on/off——是否加黑色描边阴影，保证在任意背景上都清晰可读（默认 on）
   • --position：tl、tr、bl、br、center，逗号组合，或 all（默认 br）；--mode dynamic 时本项被忽略
   • --mode：static（默认）或 dynamic
   • --motion（仅 dynamic）：drift（默认，正弦漫游）| scroll（底部向左滚动跑马灯）| bounce-h（水平来回弹）| bounce-v（垂直来回弹）
   • --margin：角标距边缘像素（默认 36）
   • --output：可选输出路径；默认在源文件旁生成 <输入>_watermark.mp4
3. 运行 scripts/watermark.py 并带上所选参数。脚本会：
   • 用 Pillow 把水印文字渲染成透明 PNG（支持混排不同字号、强调字符垂直居中、透明度直接写入 alpha 通道）
   • 构建 ffmpeg filter_complex：静态模式为一次或多次 overlay（多位置串联）；动态模式为单个 overlay 配基于时间 t 的 x/y 表达式
   • 编码 H.264（-crf 20、-preset fast、-pix_fmt yuv420p）并拷贝音频；加 -movflags +faststart 利于网页播放
   • 跑完自动清理临时徽章
4. 肉眼验证。用 ffmpeg 抽一帧检查；动态模式建议在不同时间点抽 2–3 帧确认水印确有移动。

调用示例

静态双角品牌水印（最常见）：

python scripts/watermark.py 
  --input "/abs/path/to/clip.mp4" 
  --text "源码·视界" 
  --font yahei --size 50 
  --emph-char "·" --emph-size 72 
  --color white --opacity 0.45 
  --position tl,br

防搬运动态水印：

python scripts/watermark.py 
  --input "/abs/path/to/clip.mp4" 
  --text "内部资料" 
  --color red --opacity 0.6 
  --mode dynamic --motion drift

批量处理整个文件夹：

for f in "/abs/folder"/*.mp4; do
  python scripts/watermark.py --input "$f" --position tl,br --text "我的水印"
done

资源

scripts/

• watermark.py —— 核心引擎。通过 Pillow 渲染文字徽章、构建 ffmpeg filter_complex、用 subprocess 调用 ffmpeg。ffmpeg 首次使用时自动下载（经 imageio-ffmpeg）。
• skillpay_config.json —— 技能配置文件（预留扩展）时改这里。

references/

• troubleshooting.md —— 当 ffmpeg 报错、徽章渲染异常、字体加载失败，或含中文路径报错时加载。覆盖 Git Bash “Illegal byte sequence” 的 MSYS 路径坑、Pillow 安装、字体回退、动态表达式语法、以及“？”文件名问题。