Photo Cinematic Editor#

Cinematic photo processing toolkit with Pillow + NumPy. Supports HEIC/JPEG/PNG input.

Quick Start#

bash

# All-in-one cinematic processing (dehaze → grade → light → sharpen)
python3 scripts/photo_editor.py input.jpg output.jpg

# Custom pipeline
python3 scripts/photo_editor.py input.jpg output.jpg dehaze grade saturation=1.3 light sharpen

Effects Reference#

EffectParamsDescriptiondehazestrength=1.0Local contrast dehazing + claritygradestrength=1.0Cinematic S-curve + teal/orange split tone + glow + vignettesaturationsaturation=1.0Simple saturation multipliervibrancevibrance=1.0Smart saturation (boosts muted colors more)levelsshadows=0 midtones=1.0 highlights=255Photoshop-style levels adjustmentlightstrength=1.0Warm light streaks + highlight boostsharpenstrength=1.0Unsharp mask sharpeningblurstrength=1.0Gaussian blur (radius in pixels)

All params accept strength=N to control intensity.

Usage Examples#

bash

# Dehaze only
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze

# Cinematic from scratch
python3 scripts/photo_editor.py photo.jpg out.jpg grade

# Vibrant cinematic
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze grade saturation=1.2 light sharpen

# Soft natural look
python3 scripts/photo_editor.py photo.jpg out.jpg dehaze grade vibrance=0.85 light=0.6 sharpen

# Manual levels adjustment
python3 scripts/photo_editor.py photo.jpg out.jpg levels shadows=15 midtones=1.1 highlights=240 sharpen

Requirements#

bash

pip3 install Pillow numpy pillow-heif --break-system-packages

Scripts#

• scripts/photo_editor.py — Main editor with pipeline processing
• scripts/cinematic_grade.py — V1 classic cinematic grading
• scripts/cinematic_v2.py — V2 with dehaze + light texture

References#

See references/photo-editing-guide.md for technique explanations and advanced workflows.