← 返回 Skills 市场
ozzylennon

FFmpeg Video Watermark Remover

作者 OzzyLennon · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
91
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install ffmpeg-video-watermark-remover
功能描述
Remove watermarks from videos using ffmpeg delogo filter. Use this skill whenever the user wants to remove a watermark from a video, asks to remove a logo/te...
使用说明 (SKILL.md)

Video Watermark Remover

Remove watermark/logo/text overlays from videos using ffmpeg's delogo filter.

Core Logic

Step 1: Extract sample frames Extract frames at 1-second intervals to locate watermark positions:

for t in 1 2 3 4 5; do
  ffmpeg -y -ss 00:00:0$t -i "$INPUT" -frames:v 1 "/tmp/wm_frame_$t.jpg" 2>/dev/null
done

Step 2: Analyze with vision model Use the image tool to analyze the sample frames. Ask for:

  • Exact watermark positions (which corner/edge)
  • Pixel bounding box: x, y, width, height for a WxH resolution video
  • Whether watermarks are in the same position across all frames (fixed) or move (dynamic)

Step 3: Build segmentation strategy

Fixed watermark (same position throughout):

  • One delogo pass on entire video

Dynamic watermark (position changes at specific times):

  • Identify segment boundaries (e.g., 0-3.5s bottom-right, 3.5s+ left edge)
  • Process each segment separately with its own delogo coordinates
  • Concatenate segments back together

Step 4: Process and verify

# Single segment
ffmpeg -y -i "$INPUT" -vf "delogo=x=$X:y=$Y:w=$W:h=$H" -c:a copy "$OUTPUT"

# Multiple segments
# Process each segment separately with -ss/-t, then concat

Verify each segment's result with the vision model before final delivery.

Key Parameters

Parameter Description
x, y Top-left corner of watermark region
w, h Width and height of watermark region
INPUT Input video path
OUTPUT Output video path

Finding exact coordinates:

  • Vision model gives normalized coordinates on 0-1000 scale — convert to actual pixels
  • For a 720x1280 video: actual_x = normalized_x * width / 1000
  • Always add 5-10px padding to the detected region to ensure full coverage

Dynamic Watermark Segmentation

When watermark moves between distinct positions:

  1. Identify transition points — Note which frames have watermarks at which positions
  2. Create segments — Each position change = new segment boundary
  3. Process each segment — Apply correct delogo coordinates to each time range
  4. Concatenate — Use ffmpeg concat with a manifest file:
    file 'seg1.mp4'
    file 'seg2.mp4'
    
    ffmpeg -y -f concat -safe 0 -i concat.txt -c copy output.mp4
    

Example segmentation:

Segment Time Range Watermark Position
1 0-3.5s Bottom-right (x=540,y=1195,w=165,h=55)
2 3.5-5s Left edge (x=30,y=480,w=160,h=210)

Handling Multiple Watermarks

If multiple watermarks exist simultaneously (e.g., corner logo + username handle):

  • Identify which the user wants removed vs. preserved
  • Apply multiple delogo filters in the same vf string:
    -vf "delogo=x=540:y=1195:w=165:h=55,delogo=x=30:y=480:w=160:h=210"
    

Output Delivery

  • Save to /root/.openclaw/workspace/downloads/
  • Send via message tool with media parameter
  • Confirm with user before final delivery

Limitations

  • delogo fills the region with a blurred/averaged patch — works best on simple/static backgrounds
  • Semi-transparent watermarks, complex AI-generated watermarks, and moving watermarks over textured backgrounds may still show traces
  • For AI inpainting (natural content-aware fill): this skill cannot do it — inform the user and suggest inpainting pipeline if delogo result is unsatisfactory
安全使用建议
Before installing, note three issues: (1) The code and instructions call ffmpeg and ffprobe but the skill metadata doesn't declare them — ensure ffmpeg/ffprobe and Python are available on the host. (2) The SKILL.md instructs saving output into /root/.openclaw/workspace/downloads/ and sending via a 'message' tool; confirm you are comfortable with files being written to that root-scoped workspace and with the platform message/vision tools accessing derived frames. (3) Removing watermarks may implicate copyright/usage policy — consider legal/ethical constraints. Recommended actions: request the publisher update metadata to list required binaries and any platform tools, or run the scripts locally in a sandbox to verify behavior; inspect outputs before any external sending; and avoid running on sensitive/private videos unless you control the destination/use.
功能分析
Type: OpenClaw Skill Name: ffmpeg-video-watermark-remover Version: 1.0.0 The skill bundle provides a legitimate utility for removing video watermarks using ffmpeg's delogo filter. It includes Python scripts (extract_frames.py and process_video.py) that handle frame extraction for analysis and the subsequent video processing, including support for moving watermarks via segmentation. The instructions in SKILL.md are well-defined and focused on the stated task, with no evidence of data exfiltration, malicious execution, or prompt injection.
能力评估
Purpose & Capability
The SKILL.md and both Python scripts call ffmpeg and ffprobe to extract frames and run delogo, but the skill metadata declares no required binaries or config paths. A watermark-removal skill legitimately needs ffmpeg/ffprobe (and Python), so the metadata omission is an incoherence that could hide runtime failures or surprise users.
Instruction Scope
Instructions are specific about extracting frames, using a vision model ('image' tool) to locate watermark bounding boxes, segmenting, applying ffmpeg delogo, and verifying results. This scope is reasonable for the stated task, but the SKILL.md also instructs saving outputs to /root/.openclaw/workspace/downloads/ and sending via a 'message' tool; those platform-specific I/O steps are not declared in metadata and may expose files into a root-scoped workspace without explicit consent.
Install Mechanism
No install spec (instruction-only plus small helper scripts). No third-party downloads or obscure installers. Scripts are plain Python that call system ffmpeg/ffprobe, which is a low-risk install footprint — provided the required binaries are known and available.
Credentials
The skill requests no environment variables or credentials, which is consistent with the code. However, it implicitly requires platform tools ('image' and 'message') and writes to a hard-coded root workspace path; these platform assumptions should be declared. Also the metadata should list ffmpeg/ffprobe as required binaries.
Persistence & Privilege
always is false and the skill does not request to persistently modify other skills or system-wide settings. It writes temporary files under /tmp and outputs to a workspace path; this is normal for processing tools but the target path is platform/root-scoped.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install ffmpeg-video-watermark-remover
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /ffmpeg-video-watermark-remover 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release: ffmpeg delogo based dynamic/static watermark removal for videos
元数据
Slug ffmpeg-video-watermark-remover
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

FFmpeg Video Watermark Remover 是什么?

Remove watermarks from videos using ffmpeg delogo filter. Use this skill whenever the user wants to remove a watermark from a video, asks to remove a logo/te... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 91 次。

如何安装 FFmpeg Video Watermark Remover?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install ffmpeg-video-watermark-remover」即可一键安装,无需额外配置。

FFmpeg Video Watermark Remover 是免费的吗?

是的,FFmpeg Video Watermark Remover 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

FFmpeg Video Watermark Remover 支持哪些平台?

FFmpeg Video Watermark Remover 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 FFmpeg Video Watermark Remover?

由 OzzyLennon(@ozzylennon)开发并维护,当前版本 v1.0.0。

💬 留言讨论