Photo Cinematic Editor
/install photo-cinematic
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.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install photo-cinematic - After installation, invoke the skill by name or use
/photo-cinematic - Provide required inputs per the skill's parameter spec and get structured output
What is Photo Cinematic Editor?
Professional photo processing and cinematic color grading powered by Pillow + NumPy. Use when a user asks to: (1) Edit, enhance, or retouch photos, (2) Apply... It is an AI Agent Skill for Claude Code / OpenClaw, with 11 downloads so far.
How do I install Photo Cinematic Editor?
Run "/install photo-cinematic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Photo Cinematic Editor free?
Yes, Photo Cinematic Editor is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Photo Cinematic Editor support?
Photo Cinematic Editor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Photo Cinematic Editor?
It is built and maintained by Akira362680164 (@akira362680164); the current version is v1.0.0.