Clipsmith Video Metadata Sanitize
Re-encode one local video with FFmpeg, remove hidden metadata and chapters, and scan the result for suspicious metadata keys or values. This skill does not transcribe audio, create snapshots, run OCR, write capture bundles, or redact visible frame content.
Execution
cd <clipsmith-repo>/skills/clipsmith-video-metadata-sanitize
npx tsx scripts/run.ts \
--input_video "/path/to/input.mp4" \
--output_video "$HOME/Downloads/sanitized.mp4"
Optional:
--mode metadata-onlyis the default local re-encode and metadata strip.--mode watermark-resistantenables stronger two-pass re-encode with mild scale perturbation and higher compression. Use it only when the quality trade-off is acceptable.--strictexits non-zero when suspicious hidden metadata remains.
Output:
- sanitized MP4 at
--output_video metadata_report.jsonbeside the output video- console diagnostics with before/after size, duration, dimensions, hash, EXIF count, ffprobe tags, and sensitive metadata scan status
Constraints
- Accept local video paths only.
- Require
ffmpeg,ffprobe, andexiftoolinPATH. - Never overwrite or delete the source video.
- Do not attach this to provider capture automatically.
- Treat the scan as hidden-metadata-only. It is practical-risk reduction, not guaranteed forensic erasure or visible-content desensitization.
Success Criteria
- Source video exists.
- Output video is written to a separate path.
- Metadata and chapters are stripped during re-encode.
metadata_report.jsonis written.- Sensitive metadata scan reports
PASSorREVIEW_REQUIRED.