Video-Processing-Scripts/Crop-Clips.md

Crop-Clips.ps1

Batch crop videos generated by LTX-2, Kling and Wan to standard resolutions using ffmpeg.

Every non-standard resolution these generators produce is recognised by a single lookup table in the script, so one command handles a folder containing clips from any of them. Resolutions are unique per generator, so there is no ambiguity. Any resolution not listed below is skipped without modification.

Use -Size to ignore the table and convert every video to a specific resolution instead — see Forcing a Size.

Parameters

• -Source (optional): Source directory containing video files (default: current directory)
• -Target (optional): Target directory for cropped videos (default: current directory)
• -Size (optional): Output video size. Possible values: 320p, 384p, 480p, 720p, 900p, 1080p, HD, 1440p, 2K, 2160p, 4K, or a custom width:height. When specified it overrides the resolution table and converts every video to that size — see Forcing a Size. Without it, the table below is used.

Supported Resolutions

LTX-2

Landscape:

• 3744x2112 → 3840x2160: Scale up to 3840 width, then vertical center crop
• 2496x1408 → 2560x1440: Scale up to 2560 width, then vertical center crop
• 2160x1216 → 1920x1080: Scale down to 1920 width, then vertical center crop
• 1920x1088 → 1920x1080: Center crop (removes 4px from top and bottom)
• 1920x1056 → 1920x1080: Scale up to 1080 height, then horizontal center crop
• 1872x1056 → 1920x1080: Scale up to 1920 width, then vertical center crop
• 1600x896 → 1600x900: Scale to 900 height, then center crop
• 1312x704 → 1280x720: Scale up to 720 height, then horizontal center crop
• 1280x704 → 1280x720: Scale to 720 height, then center crop
• 1248x704 → 1280x720: Scale up to 1280 width, then vertical center crop
• 832x448 → 854x480: Scale to 480 height, then center crop
• 640x384 → 684x384: Scale to 684 width, then center crop
• 576x320 → 570x320: Center crop (removes 3px from left and right)

Portrait:

• 2112x3744 → 2160x3840: Scale up to 3840 height, then horizontal center crop
• 1408x2496 → 1440x2560: Scale up to 2560 height, then horizontal center crop
• 1216x2160 → 1080x1920: Scale down to 1920 height, then horizontal center crop
• 1088x1920 → 1080x1920: Center crop (removes 4px from left and right)
• 1056x1920 → 1080x1920: Scale up to 1080 width, then vertical center crop
• 1056x1872 → 1080x1920: Scale up to 1920 height, then horizontal center crop
• 896x1600 → 900x1600: Scale to 900 width, then center crop
• 704x1312 → 720x1280: Scale up to 720 width, then vertical center crop
• 704x1280 → 720x1280: Scale to 720 width, then center crop
• 704x1248 → 720x1280: Scale up to 1280 height, then horizontal center crop
• 448x832 → 480x854: Scale to 480 width, then center crop
• 384x640 → 384x684: Scale to 684 height, then center crop
• 320x576 → 320x570: Center crop (removes 3px from top and bottom)

Kling

• 1928x1072 → 1920x1080: Scale to 1080 height, then center crop width to 1920
• 1920x1076 → 1920x1080: Scale to 1080 height, then center crop width to 1920
• 1920x1072 → 1920x1080: Scale to 1080 height, then center crop width to 1920
• 1916x1080 → 1920x1080: Already 1080 tall, so the 4 missing columns are padded (centered) instead of rescaling

Wan

• 1928x1076 → 1920x1080: Scale to 1080 height, then center crop width to 1920
• 1926x1076 → 1920x1080: Scale to 1080 height, then center crop width to 1920
• 1284x716 → 1280x720: Scale to 720 height, then center crop width to 1280

Square (1:1)

• NxN → 1080x1080: Any square resolution other than 1080x1080 is scaled up or down to 1080x1080 (no crop needed)

Forcing a Size

-Size bypasses the resolution table entirely. Every video is cover-scaled (force_original_aspect_ratio=increase, which preserves the pixel aspect ratio and guarantees the frame is fully covered) and then centre-cropped to the exact requested size — the same approach as Clone-Image.ps1. Because the table is not consulted, resolutions that would normally be skipped are converted too.

Presets

Named presets are the landscape targets this script already produces:

Preset	Size	Preset	Size
320p	570x320	1080p / HD	1920x1080
384p	684x384	1440p / 2K	2560x1440
480p	854x480	2160p / 4K	3840x2160
720p	1280x720
900p	1600x900

Preset names are case-insensitive (-Size hd works).

Portrait sources

Presets are transposed for portrait sources, so a 9:16 clip stays 9:16 instead of losing most of the frame to a landscape crop:

Source	-Size 1080p	-Size 720p
1920x1088 (landscape)	1920x1080	1280x720
640x480 (landscape)	1920x1080	1280x720
512x512 (square)	1920x1080	1280x720
1080x1920 (portrait)	1080x1920 (already — skipped)	720x1280
720x1280 (portrait)	1080x1920	720x1280 (already — skipped)

A custom width:height is always used exactly as given (never transposed), so -Size 1080:1920 forces portrait output for every video, landscape sources included. Odd custom dimensions are rounded up to the next even number, as libx264/yuv420p requires even sizes (-Size 571:321 becomes 572x322).

Already-correct videos

A video that is already exactly the requested size is left untouched — no re-encode, no generation loss:

Skipping: 1920x1080.mp4 (already 1920x1080)

An invalid -Size value fails immediately, before any file is processed.

Behavior

• Processes all .mp4 files in source directory
• Skips files ending with .bak.mp4 or .skip.mp4
• Automatically detects resolution and applies appropriate crop filter (or uses -Size when given)
• Preserves original quality and audio
• In-place mode (source and target are the same directory). This is the default when -Source and -Target are both omitted, because both default to the current directory:
  • Each original video.mp4 is copied to video.bak.mp4. An existing .bak.mp4 is replaced.
  • The cropped result is written to video.crop.mp4. Only after that succeeds is the original video.mp4 deleted and replaced by the cropped file. The .bak.mp4 backup is kept.
  • Run with -WhatIf first, and do not run it on a folder you have not designated.
• Separate target folder: the source files are not changed. A file with the same name already in the target folder is deleted and replaced.
• If ffmpeg fails, the partial .crop.mp4 file is deleted and the script stops with an error

Examples

Crop videos in current directory:

.\Crop-Clips.ps1

Crop videos from specific source:

.\Crop-Clips.ps1 -Source "C:\Videos\Input"

Crop to different target directory:

.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Target "C:\Videos\Output"

Force every video to 1080p (table ignored):

.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Size 1080p
# Landscape clips -> 1920x1080, portrait clips -> 1080x1920

Force a small preset:

.\Crop-Clips.ps1 -Size 480p
# Landscape clips -> 854x480, portrait clips -> 480x854

Force a custom size (used verbatim, never transposed):

.\Crop-Clips.ps1 -Size "1080:1920"
# Every video becomes 1080x1920, landscape sources included

Skip specific files:

# Rename files to skip processing:
# video.mp4 -> video.skip.mp4
.\Crop-Clips.ps1

Safe Execution

This script supports -WhatIf and -Confirm for safe execution:

• -WhatIf: Simulate the operation without actually modifying files. Shows what would be cropped.
• -Confirm: Prompt for confirmation before processing each video file.

Simulate without making changes:

.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Target "C:\Videos\Output" -WhatIf

Prompt before each file:

.\Crop-Clips.ps1 -Source "C:\Videos\Input" -Confirm