ffmpeg-lens-perspective

Community

Fix lens distortion and keystone in FFmpeg.

Authordamionrashford
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Corrects common optical issues in video workflows by applying FFmpeg filters to remove lens distortion, fix perspective, and adjust vignetting and rotation.

Core Features & Use Cases

  • Lens distortion correction using lenscorrection (k1/k2) and optional lensfun integration for camera-specific profiles.
  • Perspective/keystone correction via four-corner warp and optional interpolation modes.
  • Additional geometric transforms including vignette adjustment, rotation, shear, and tiltandshift for cinematic tweaks.
  • CLI with subcommands for undistort-barrel, undistort-pincushion, lensfun, perspective, vignette, rotate, shear, and tiltandshift.

Quick Start

Run the lens.py script with your input and output paths to generate the appropriate ffmpeg command for a chosen transform.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: ffmpeg-lens-perspective
Download link: https://github.com/damionrashford/media-os/archive/main.zip#ffmpeg-lens-perspective

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.