clop-compress

Compress images, videos, PDFs, and audio files using the Clop CLI on macOS.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/karenrebecag/spec-driven-standards --skill clop-compress-karenrebecag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clop-compress
Source: https://github.com/karenrebecag/spec-driven-standards/tree/main/plugins/mac-ops/skills/clop-compress
Command: npx skills add https://github.com/karenrebecag/spec-driven-standards --skill clop-compress-karenrebecag

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Media files from cameras and exports are far larger than needed for web, email, or storage, and compressing them safely requires knowing the right encoder settings, avoiding in-place destruction of originals, and preserving metadata like EXIF. ## Core Features & Use Cases - Measured compression scales: Provides tested compression levels for JPEG (5-100 scale), video encoders (hardware, software, lossless, adaptive), and PDF DPI settings with real savings percentages. - Safe copy-first workflow: Always copies originals before compressing since Clop modifies files in place, and restores EXIF metadata with exiftool after compression. - CLI trap documentation: Covers pitfalls like output template syntax (%f includes extension), MOV-to-MP4 conversion leaving duplicates, missing ffprobe, and format skip lists. - Use Case: You have a folder of 200 camera photos totaling 1.3 GB that need to go on a website. Copy the folder, run Clop at compression 64 recursively, verify integrity with ffmpeg decoding, and restore EXIF dates so the photos sort correctly. ## Quick Start Compress all images in my vacation-photos folder to web-ready size without touching the originals and keep the EXIF dates intact.

Frequently Asked Questions about clop-compress

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I compress images with the Clop CLI on macOS?

Run clop optimise image with a --compression value from 5 (best quality) to 100 (smallest file), plus -n to hide the progress bar and -r for recursive folders. Always copy originals first since Clop modifies files in place by default.

What compression level should I use for web images?

Use --compression 64 for web assets, which measured 93% savings on an 18MP camera JPEG with artifacts only starting to appear in skies and gradients. Level 50 is the recommended default with no visible artifacts at 90% savings.

Does Clop preserve EXIF metadata when compressing photos?

No, Clop always strips all EXIF data including capture date, camera model, and GPS. Restore it afterward with the bundled exiftool using -TagsFromFile to copy metadata from the originals, costing about 21 KB per photo.

Hardware vs software video encoder in Clop, which is better?

Testing on 1080p H.264 footage showed the hardware encoder winning on both size (86% savings) and speed (2 seconds), contradicting the CLI help text. Measure on your own footage before assuming software produces smaller files.

Why does Clop output create files with double extensions like .jpg.JPG?

The %f output template variable already includes the correct extension, so writing -o "dest/%f.jpg" appends a second one. Use only -o "dest/%f", and note that -o with an existing directory creates a sibling file instead of writing inside it.

How do I verify compressed files are not corrupted?

Decode every output file with ffmpeg using -v error -f null to detect truncation and corruption, then compare file counts between source and destination. For video, also compare durations since mismatches indicate truncated encoding.