Automate your CapCut Desktop post-production — bulk apply zooms, effects, and transitions instantly
A personal project to speed up repetitive video editing — contributions welcome!
⬇ Download for macOS ⬇ Download for Windows
CapCut Auto Editor is a desktop application that lets you batch process multiple CapCut projects in seconds. It completely automates the tedious post-production steps.
Instead of opening every project manually to apply zooms to photos and toss effects onto clips, you simply select your draft projects in this app, click Edição Mágica, and it manipulates the CapCut internal JSON timelines directly.
No manual clicking. No rendering bottleneck. Just instant timeline routing.
CapCut Auto Editor now supports two distinct editing workflows to match your style:
- 💥 Random Mode (Fully Automated): The original behavior. The app completely ignores your existing timeline timing. It calculates your main audio track length, then randomly slices and duplicates your media pool to perfectly fill out the duration. Ideal for quick generative montages.
- 🎯 Controlled Mode (Manual Cuts): You do the raw cuts in CapCut exactly in rhythm with your music. The app strictly respects your manual start times and clip durations, but automates the heavy post-production by injecting transitions between your cuts, zoom-in keyframes for photos, blur and duplicated background for vertical images, vignette effects, and master fade in/out.
This is a personal project. I built it because I needed to automate repetitive editing workflows on CapCut Desktop and there was no official API available.
It works by directly editing the secret draft_info.json and timeline metadata files that CapCut creates on your machine. It reconstructs the tracks, assigns random scale keyframes (zooms), handles non-16:9 overlays, and injects fade animations directly into the database.
It might be rough around the edges, and if CapCut changes their JSON schema radically, things might break. But for now, it saves hours of manual work. If you find it useful or want to add more effects, feel free to contribute!
1. Download the installer for your platform from the links above.
2. Open the App: You will see a grid with all your local CapCut projects.
3. Run Magic Edit: Select as many projects as you want and click the magic button. It will process everything in the background. Once finished, open CapCut and your timelines will be fully edited.
Requires Node.js installed.
git clone https://github.com/Saimonsanbr/capcut-auto-editor
cd capcut-auto-editor
npm install
npm start- The app reads your local CapCut
Projects/com.lveditor.draftfolder. - It intelligently handles different CapCut schema versions depending on your OS and updates:
- Modern/Windows pattern: Finds
draft_content.jsondirectly in the project root. - Legacy/macOS pattern: Follows
timeline_layout.jsonto finddraft_info.jsoninside theTimelines/directory.
- Modern/Windows pattern: Finds
- It creates a complete backup of your timeline JSON just in case.
- It iterates over your
main_video_track, separates elements, and recalculates times. - It injects new UUIDs for VFX materials (like Vignettes, Fades, and Old Comedy effects) directly into the CapCut Cache pool.
- It syncs the modified timestamps with
root_meta_info.jsonso the CapCut UI recognizes the changes instantly upon opening.
Use electron-builder to package the app for your system:
For macOS (creates a .dmg and .app in /dist):
npm run buildFor Windows (creates a .exe in /dist):
npm run build:win(Note: Compiling for Windows is best done on an actual Windows machine to avoid native dependency issues).
By default, the app looks for effects in a local assets/effects/ folder. If they aren't found, it gracefully falls back to your machine's CapCut installation Cache directory (AppData/Local/... on Windows or Library/Containers/... on Mac).
To add custom VFX or Transitions, edit src/backend/effects.js and map the CapCut resource IDs to your new logic.
MIT.