pycapcut

A lightweight, flexible, and easy-to-use Python tool for generating and exporting CapCut drafts to build fully automated video editing/remix pipelines!

🧪 This project is being migrated from PyJianYingDraft. Please ⭐️ to stay tuned!

📢 Join the Discord server to discuss usage and new features

Workflow

Feature List

ℹ Please refer to Github Repository for full documentation.

Template Mode

🧪 This module has just been migrated. If something doesn’t fit your template, please open an issue.

• ☑️ Load an (unencrypted) draft_content.json file as a template
• ☑️ Replace media for video/audio segments
• ☑️ Modify text contents of text segments
• ☑️ Import entire audio/video/text tracks from a template draft into another draft
• ☑️ Extract resource metadata (stickers/bubbles/fancy text, etc.)

Batch Export

⚠️ This module is being migrated. If interested, see the corresponding part in PyJianYingDraft

• ☑️ Control CapCut to open a specific draft
• ☑️ Export a draft to a specific location
• ☑️ Adjust export resolution and frame rate

Video and Image

🧪 This module has just been migrated. If animations/effects/transitions don’t take effect, please open an issue.

• ☑️ Add local video/image media, and customize segment timing, duration, or playback speed
• ☑️ Global video adjustments (rotation, scale, brightness, etc.) and keyframe generation
• ☑️ In/Out/Group animations for video segments
• ☑️ Add masks, segment effects, and filters
• ☑️ Video background fill (example code)

Stickers

• ☑️ Add stickers based on metadata extraction
• ☑️ Keyframe generation for stickers

Audio

• ☑️ Add local audio media, and customize segment timing, duration, or playback speed
• ☑️ Adjust fade in/out durations (example code), adjust volume (example code), and its keyframes
• ☑️ Add scene audio effects to audio segments and configure parameters

Tracks

• ☑️ Add tracks and append segments to a specific track
• ☑️ Customize layer ordering among video/filter/effect tracks

Effects, Filters, and Transitions

• ☑️ Clip-attached effects, filters, and animations
• ☑️ Standalone tracks for effects and filters
• ☑️ Add transitions (example code) and customize duration

Text and Subtitles

• ☑️ Add text, set fonts and styles, modify position and rotation of text segments
• ☑️ Keyframes and animations for text
• ☑️ Text stroke and text background
• ☑️ Text bubble effects and fancy text effects (example code)
• ☑️ Automatic line wrapping with configurable max line width
• ☑️ Import .srt files to create subtitles in bulk and style them

ℹ The Github Repository contains a demonstration of the above features.