Skip to content

GuanYixuan /pyJianYingDraft

JianYing draft files from Python, so you can script your edits
Editing & audioApache-2.0Chinese README
Stars
4.9k
30 days
+324
Last push
1 month ago

About pyJianYingDraft

pyJianYingDraft is a free Python library that writes JianYing (CapCut China) draft files, so you build the timeline in code instead of dragging clips by hand. It handles video, images, audio, stickers, text, subtitles, effects and transitions, and the drafts open in JianYing 5.9 and 10.8. Auto-export only works on Windows with JianYing 6 or older.

Best for: Python-savvy editors who want to automate JianYing edits, including AI short-drama assembly.

What it does

  • Adds video, image, audio, sticker and text clips to a draft
  • Controls tracks: append or insert above and below existing ones
  • Sets crop, speed, keyframes, masks, chroma key and blend modes
  • Styles text and subtitles, and imports .srt files
  • Reuses an existing draft as a template and swaps materials or text
  • Exports drafts in a batch on Windows with JianYing 6 and below

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Install with pip install pyJianYingDraft (Python 3.8 or 3.11 works best).
  2. 2
    Find your JianYing draft folder path (something like .../JianyingPro Drafts) and put it in demo.py where the placeholder is.
  3. 3
    Run demo.py to make a sample draft with audio, video, text, fades, an entrance animation and a transition.
  4. 4
    Open the new demo draft in JianYing. You may need to enter and leave another draft, or restart JianYing, to refresh the list.

Models and languages

Interface and docs

  • Chinese

Common questions

What people ask when they look this repo up, answered from its issues and docs.

What is pyJianYingDraft?
A free Python library (Apache-2.0) that writes JianYing draft files from code. You add clips, audio, text and subtitles with Python, then open the draft in JianYing and finish it there. Install it with pip install pyJianYingDraft. Source
Does pyJianYingDraft work with CapCut?
Not this library. It writes drafts for JianYing, the China version of the editor. The author is building a separate CapCut version in another repo, GuanYixuan/pyCapCut, and it's still in development. Source
Can I use pyJianYingDraft on a Mac?
Partly. On macOS and Linux you can build drafts and use template mode. Auto-export won't run, because it uses uiautomation, a Windows-only library. You still need JianYing on Windows to export the final video. Source
Can pyJianYingDraft read drafts from new JianYing versions?
Drafts it creates open in JianYing 10.8, and masks work there too since 0.3.1. Loading a new-version draft as a template is harder: its draft_content.json usually isn't plain JSON, so you must plug in your own reader via fallback_loader. The project won't ship a decryption tool. Source
Does pyJianYingDraft auto-export work on new JianYing?
No. Auto-export clicks JianYing's on-screen controls, and versions 7 and up usually don't expose them. The README marks it working on 6.8 and failing on 10.8. Use JianYing 6 or older on Windows, or export each draft by hand. Source
How do I stop JianYing 5.9 from updating itself?
Users say this works. Delete update.exe in AppData\Local\JianyingPro\User Data\Download, then make a read-only folder named update.exe in its place. Another fix is a portable 5.9 you always launch from its own folder. Source
What's the latest pyJianYingDraft version?
0.3.1, out October 14, 2026. It fixes masks on new JianYing and adds trange_seconds for time ranges in seconds, which stops back-to-back clips overlapping by 1 microsecond. 0.3.0 (July 2026) replaced add_track with append_track and insert_track, so older scripts may break. Source

Alternatives

Other editing & audio projects people compare with pyJianYingDraft.

sun-guannan

VectCutAPI

API and MCP server for turning AI clips into CapCut and Jianying drafts

Editing & audio
2.4k GitHub stars+69/30d10 days agoApache-2.0

luoluoluo22

jianying-editor-skill

Drives JianYing Pro: builds drafts, adds voiceover and subtitles

Editing & audio
  • Imagen 3
  • Grok 3
  • Claude 4.5
  • +2
4.4k GitHub stars+751/30d2 months agoMIT

Hommy-master

capcut-mate

Call an API to build Jianying or CapCut drafts and render video

Editing & audio
2.2k GitHub stars+190/30d3 days agoApache-2.0

RVC-Boss

GPT-SoVITS

Clones a voice from a 5-second clip and reads your text in it

Editing & audio
  • GPT-SoVITS v2Pro / v2ProPlus
  • GPT-SoVITS v4
  • GPT-SoVITS v3
  • +7
65k GitHub stars+2.2k/30d6 days agoMIT

Featured on OpenMicroDrama

Do you maintain pyJianYingDraft? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/guanyixuan-pyjianyingdraft)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 17, 2026. A separate CapCut version is in development in another repository. We write these descriptions ourselves. The repo's own docs are the final word.