Skip to content

ljniox/video-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Video CLI

FFmpeg-powered video editing pipeline for Claude Code — color grading, montage, transitions, text overlays, and social media export.

Features

  • 9 color grading presets — cinematic warm/cold, teal-orange, vintage film, moody dark, bright clean, sunset golden, B&W, pastel
  • Full montage pipeline — intro + clips + outro with grading, transitions, and text overlay in one command
  • 23 transitions — fade, dissolve, wipe, slide, circle, radial, pixelize...
  • Text overlays — titles, subtitles, CTAs with positioning, timing, and fade-in
  • Social media export — TikTok, Instagram, YouTube, LinkedIn, Twitter, WhatsApp with correct dimensions
  • Video stabilization — 2-pass vidstab
  • Trim, concat, resize — all the basics

Requirements

  • Python 3.10+
  • FFmpeg 6.x+ (with libx264, xfade support)

Usage

V=~/dev/_claude/video-cli/video_cli.py

# List all presets, formats, transitions
python3 $V presets

# Color grading
python3 $V grade -i video.mp4 -p cinematic-warm

# Concatenate with transitions
python3 $V concat intro.mp4 main.mp4 outro.mp4 -t fadeblack -d 0.5

# Text overlay
python3 $V text -i video.mp4 --text "NIOX" --position center --size 80

# Resize for TikTok
python3 $V resize -i video.mp4 -f tiktok

# Full montage pipeline
python3 $V montage \
  --intro intro.mp4 \
  --clips speech.MOV broll.mp4 \
  --outro outro.mp4 \
  -g cinematic-warm -t fadeblack -f tiktok \
  --title "NIOX" --subtitle "Accompagnement IA"

Color Grading Presets

Preset Style
cinematic-warm Film look chaud, tons dorés
cinematic-cold Tons bleutés, contrastes forts
cinematic-teal-orange Blockbuster teal & orange
vintage-film Pellicule vintage avec grain
moody-dark Sombre, désaturé, thriller
bright-clean Lumineux et vif — YouTube/TikTok
sunset-golden Golden hour
bw-contrast Noir et blanc dramatique
pastel-soft Pastels doux, editorial

Integration

Works with the full Claude Code content pipeline:

  1. canva-cli — design thumbnails and title cards
  2. video-cli — edit, grade, and export videos
  3. tiktok-manager — upload and schedule to TikTok

License

MIT

About

FFmpeg video editing CLI for Claude Code — color grading, montage, transitions, social media export

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages