pyJianYingDraft
轻量、灵活、易上手的Python剪映草稿生成及导出工具，构建全自动视频剪辑/混剪流水线！
🧪 本项目的CapCut版本正在开发中，欢迎关注CapCut版本仓库
📢 欢迎加入Discord服务器进行用法或新功能的讨论
使用思路
功能清单
🧪 当前版本
0.3.1新增trange_seconds，并修复剪映10.8的视频蒙版兼容和重复设置视频混合模式的问题。若遇到问题，欢迎提出issue。
视频与图片
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 本地视频/图片素材与时间控制 | ✅ | 10.8 ✅ |
| 视频整体调节 | ✅ | 10.8 ✅ |
| 视频关键帧 | ✅ | 10.8 ✅ |
| 视频蒙版 | ✅ | 10.8 ✅ |
| 视频色度抠图 | ✅ | 10.8 ✅ |
| 视频背景填充(示例代码) | ✅ | 10.8 ✅ |
| 视频混合模式 | ✅ | 10.8 ✅ |
贴纸
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 贴纸 | ✅ | 10.8 ✅ |
| 贴纸关键帧 | ✅ | 10.8 ✅ |
音频
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 本地音频素材与时间控制 | ✅ | 10.8 ✅ |
| 音频淡入淡出与音量 | ✅ | 10.8 ✅ |
| 音频场景音、音色效果 | ✅ | 10.8 ✅ |
| 音频声音成曲效果 | ❌ 不生效 |
10.8 ✅ |
轨道
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 添加轨道与添加片段 | ✅ | 10.8 ✅ |
| 轨道顺序控制 | ✅ | 10.8 🟡 从其它草稿导入的轨道可能存在顺序问题 |
特效、滤镜和转场
⚠️ 剪映在打开草稿时会尝试自动下载未缓存的动画/特效/转场等，但有可能会超时，表现为“xx加载失败”，这个问题在5.9上出现较多
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 视频片段动画 | ✅ | 10.8 ✅ |
| 视频片段特效 | ✅ | 10.8 ✅ |
| 视频片段滤镜 | ✅ | 10.8 ✅ |
| 独立轨道特效 | ✅ | 10.8 ✅ |
| 独立轨道滤镜 | ✅ | 10.8 ✅ |
| 转场(示例代码) | ✅ | 10.8 ✅ |
文本及字幕
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 文本与样式 | ✅ | 10.8 ✅ |
| 字体 | 🟡 未缓存的字体需要二次打开草稿 |
10.8 🟡 未缓存的字体需要二次打开草稿 |
| 文本关键帧 | ✅ | 10.8 ✅ |
| 文本动画 | ✅ | 10.8 ✅ |
| 文字描边、背景和阴影 | ✅ | 10.8 ✅ |
| 文字气泡效果和花字效果(示例代码) | ✅ | 10.8 ✅ |
| 文本自动换行 | ✅ | 10.8 ✅ |
导入 .srt 字幕 |
✅ | 10.8 ✅ |
模板模式
⚠️ 新版剪映中的
draft_content.json往往不是可直接读取的明文 JSON；因此“加载模板”相关能力在新版剪映上通常需要通过DraftFolder(..., fallback_loader=...)接入额外读取器，详情请参见此处
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
加载 draft_content.json 文件作为模板 |
✅ | 10.8 🟡 需 fallback_loader |
| 替换音视频片段的素材 | ✅ | 10.8 🟡 依赖模板可读 |
| 修改文本片段的文本内容 | ✅ | 10.8 🟡 依赖模板可读 |
| 将模板草稿中的音视频/文本轨道整体导入到另一草稿中 | ✅ | 10.8 🟡 依赖模板可读 |
| 提取模板中出现的贴纸/气泡/花字等元信息 | ✅ | 10.8 🟡 依赖模板可读 |
批量导出
⚠️ 自动导出依赖旧版剪映可见控件；新版（7及以上）剪映通常不再满足这一前提
| 功能名称 | 5.9 支持状态 | 新版剪映支持状态 |
|---|---|---|
| 控制剪映打开指定草稿 | ✅ | 6.8（剪映6及以下）✅ 10.8（剪映7及以上）❌ |
| 导出草稿至指定位置 | ✅ | 6.8（剪映6及以下）✅ 10.8（剪映7及以上）❌ |
| 调节导出分辨率和帧率 | ✅ | 6.8（剪映6及以下）✅ 10.8（剪映7及以上）❌ |
安装
pyJianYingDraft现已支持pip安装（不含demo），推荐使用开发时测试的Python版本3.8或3.11
pip install pyJianYingDraft
ℹ 关于剪映5.9版本的自动升级问题，可参见相关issue
跨平台兼容性
- Windows：支持包括草稿生成、模板模式和自动导出在内的所有功能（具体可能受到剪映版本限制）
- Linux/MacOS：支持草稿生成和模板模式，但不支持自动导出，且注意生成的草稿仍然需要在Windows版剪映下导出。
1 maintainer
Metadata
1 maintainer
Release files for pyjianyingdraft 0.3.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pyjianyingdraft-0.3.1.tar.gz | 325.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pyjianyingdraft-0.3.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 661.9 kB
Release files / pyjianyingdraft-0.3.1.tar.gz
| Download URL | pyjianyingdraft-0.3.1.tar.gz |
|---|---|
| Size | 325.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c2299d03f85f5f8fbd9ef92620f3a7f5c10cd2dcbde2da38c6b5e0a98e765d0
|
|
BLAKE2b-256 checksum How to use checksums |
0ced59a64e5a1c88577261bbaa8a98dc5332a8d07ca09561f9947de943c5fe51
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.10
|
Release files / pyjianyingdraft-0.3.1-py3-none-any.whl
| Download URL | pyjianyingdraft-0.3.1-py3-none-any.whl |
|---|---|
| Size | 336.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6ce5efb014caff01b6d1ae433d109d8fb4861924d3ec06b6fc8f9431c89c7ae8
|
|
BLAKE2b-256 checksum How to use checksums |
b74a2ad80da9f30d6bbfac2079b3a89543f63e145c6a1669ff429d9c4ba2b830
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.8.10
|
