← Back to Skills Marketplace
ozzylennon

FFmpeg Video Watermark Remover

by OzzyLennon · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
91
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install ffmpeg-video-watermark-remover
Description
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...
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ffmpeg-video-watermark-remover
  3. After installation, invoke the skill by name or use /ffmpeg-video-watermark-remover
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: ffmpeg delogo based dynamic/static watermark removal for videos
Metadata
Slug ffmpeg-video-watermark-remover
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.

How do I install FFmpeg Video Watermark Remover?

Run "/install ffmpeg-video-watermark-remover" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is FFmpeg Video Watermark Remover free?

Yes, FFmpeg Video Watermark Remover is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does FFmpeg Video Watermark Remover support?

FFmpeg Video Watermark Remover is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created FFmpeg Video Watermark Remover?

It is built and maintained by OzzyLennon (@ozzylennon); the current version is v1.0.0.

💬 Comments