name: video-compress
description: Compress videos to a target file size using ffmpeg two-pass encoding. Useful for Discord/Slack upload limits.

Video Compress Skill

Compress videos to a target file size using ffmpeg two-pass encoding.

Usage

~/.pi/repos/pi-skills/video-compress/compress.sh <input> <output> [options]

Options:
- --target MB - Target size in MB (default: 10)
- --scale WIDTH - Scale to width, 0 to disable (default: 1920)
- --no-audio - Remove audio track (good for screen recordings)

Examples

# Discord upload (10MB, no audio)
compress.sh recording.mov out.mp4 --no-audio

# Slack (25MB with audio)
compress.sh video.mov out.mp4 --target 25

# Keep original resolution
compress.sh video.mov out.mp4 --scale 0

# Lower res for very long videos
compress.sh long.mov out.mp4 --target 10 --scale 1280

How it works

1. Gets video duration via ffprobe
2. Calculates target bitrate at 95% of target (to stay safely under)
3. Runs two-pass x264 encoding
4. Scales to 1920px width and 30fps by default