Repolode
Submit
renezander030

renezander030/capcut-cli

Unofficial command-line tool that reads and edits local CapCut and JianYing draft projects, with no API or server required.

Open-source alternative to:CapCut

View on GitHubWebsite
Stars
920
Forks
96
Open issues
5
Last commit
yesterday

What is it?

capcut-cli is a Node.js command-line tool for creating and editing CapCut and JianYing (剪映) projects. It works directly on the local draft store, reading and writing draft_content.json and draft_info.json, so edits stay on tracks that remain editable when the project is opened in the app. Nothing is uploaded and no server runs in the background.

The tool covers common editing jobs: inspecting tracks and segments, adding video, audio and text, trimming, adjusting speed and volume, applying templates, and generating or importing SRT subtitles. It also includes long-form-to-short helpers such as scene and silence detection, and it can render a low-resolution ffmpeg preview. Commands output JSON by default, with a human-readable table option, and a JianYing namespace flag is available.

Beyond the CLI, the project ships a library API, a JSONL queue runner for automation tools, and an agent skill that can be installed into several AI coding assistants. It is MIT licensed and is not affiliated with ByteDance.

Key features

  • 01Reads and writes local CapCut and JianYing draft files without an API.
  • 02Adds, trims and adjusts video, audio and text segments on editable tracks.
  • 03Imports and exports SRT and VTT subtitles.
  • 04Detects scenes and silences to help cut long videos into shorts.
  • 05Outputs JSON by default for scripting, with an optional table view.
  • 06Ships a library API and a JSONL runner for automation.

Use cases

  • Batch-generating captioned short videos from long recordings.
  • Applying a consistent template or subtitle style across many drafts.
  • Letting an AI agent inspect or modify CapCut projects through a command-line interface.
  • Translating or correcting subtitles in existing CapCut projects.

Topics

#video-editing#capcut#jianying#subtitles#cli#automation#video-production#agent-skills#ai-agent#capcut-api

FAQ

What is capcut-cli?
Unofficial command-line tool that reads and edits local CapCut and JianYing draft projects, with no API or server required. capcut-cli is a Node.js command-line tool for creating and editing CapCut and JianYing (剪映) projects. It works directly on the local draft store, reading and writing draft_content.json and draft_info.json, so edits stay on tracks that remain editable when the project is opened in the app. Nothing is uploaded and no server runs in the background.
Is capcut-cli free to use? What license does it have?
capcut-cli is open source under the MIT license. Check the license terms before using it in commercial products.
Is capcut-cli still maintained?
Actively maintained. The last commit to capcut-cli was on Oct 18, 2026.
What can I use capcut-cli for?
Batch-generating captioned short videos from long recordings. Applying a consistent template or subtitle style across many drafts. Letting an AI agent inspect or modify CapCut projects through a command-line interface. Translating or correcting subtitles in existing CapCut projects.
Where can I get capcut-cli?
The source code and installation instructions are on GitHub: https://github.com/renezander030/capcut-cli

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects