Photo Cinematic Editor
Cinematic photo processing toolkit with Pillow + NumPy. Supports HEIC/JPEG/PNG input.
Quick Start
# 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
| Effect | Params | Description |
|---|---|---|
dehaze | strength=1.0 | Local contrast dehazing + clarity |
grade | strength=1.0 | Cinematic S-curve + teal/orange split tone + glow + vignette |
saturation | saturation=1.0 | Simple saturation multiplier |
vibrance | vibrance=1.0 | Smart saturation (boosts muted colors more) |
levels | shadows=0 midtones=1.0 highlights=255 | Photoshop-style levels adjustment |
light | strength=1.0 | Warm light streaks + highlight boost |
sharpen | strength=1.0 | Unsharp mask sharpening |
blur | strength=1.0 | Gaussian blur (radius in pixels) |
All params accept strength=N to control intensity.
Usage Examples
# 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
pip3 install Pillow numpy pillow-heif --break-system-packages
Scripts
scripts/photo_editor.py— Main editor with pipeline processingscripts/cinematic_grade.py— V1 classic cinematic gradingscripts/cinematic_v2.py— V2 with dehaze + light texture
References
See references/photo-editing-guide.md for technique explanations and advanced workflows.