# JYDo

**Repository Path**: grabby_Tester/JYDo

## Basic Information

- **Project Name**: JYDo
- **Description**: 草稿生成、导出RPA、【素材】组合替换、自定义脚本替换
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-04-01
- **Last Updated**: 2025-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

本项目是在[pyJianYingDraft](https://github.com/GuanYixuan/pyJianYingDraft)项目基础上
新增实际使用场景所运用的功能：

- 增加无意义音频轨道、无意义视频轨道---去重
- 增加图片、视频随机入场动画---去重
- 对素材组合---可重复随机组合、不可重复随机组合

# 结构

![](/doc/3.png)

# 组合配置说明

```json
#  批量-替换素材路径
BASE_DIR = "D:\\<模板素材存放的位置>"
#  草稿-模板名称
TEMPLATE_NAME = "<剪映模板的名称>"
#  草稿-名称前缀
COMBO_NAME_PREFIX = "<生成的视频名称前缀>"

#  素材映射关系
#  index 启始0，从轨道最下面开始算（要分类，例如文本音轨总计有2个，的第几个）
#  文本轨道的 key结构 text-track_{text_track_index}_{segment_index}
#  贴纸的 key结构 sticker-segment_{text_track_index}_{segment_index}
#  0：素材不可以重复、1：素材可以重复

MATERIAL_MAPPING = {
"BGM.MP3": ("BGM", 0), #确保：素材名称和模板中素材存储文件夹，名称一致
"封面.png": ("封面", 0),
"口播音频.wav": ("口播音频", 1),
"视频_1.mp4": ("视频_1", 0),
"视频_2.mp4": ("视频_2", 0),
"视频_3.mp4": ("视频_3", 0),
"视频_4.mp4": ("视频_4", 0),
"视频_5.mp4": ("视频_5", 0),
}
```

## 配置文件

![](/doc/1.png)

## 运行

![](/doc/2.png)

## 组合记录文件

![](/doc/4.png)

## 替换素材存储样例

![](/doc/5.png)

## 运行效果

![](/doc/6.mp4)

# 完全非组合的

直接参考[pyJianYingDraft](https://github.com/GuanYixuan/pyJianYingDraft)的demo

# 素材文件夹目录结构说明

```
  **** 以产品展示为例 ****
  - 产品展示
  **** 以下为【剪映模板】的文件夹目录 ****
     - 模板1-产品展示
  **** 以下为【替换素材】的文件夹目录 ****
     - 封面-1
             *.mp4、*.jpg、*.png
     - 视频-1
             *.mp4、*.jpg、jpeg、*.png
     - 文本-1
             *.csv、*.txt
     - 音频-1
             *.wav、*.mp3
     - 抠--像-1
             抠--像-*.png、抠--像-*.jpg
  **** 以下为【模板】中需要【媒体关联】的素材 ****
  *.mp4、*jpg、*png、 *.wav、*.mp3
```

## 剪映模板

### 模板素材-命名

- 模板使用的素材名称建议使用有【视频、封面、音乐】有代表意义的名称，例如：封面-1、视频-1

### 其余注意事项

- 建议删除 模板 中没有使用到的素材
- 模板轨道 的排序：
  文本放在一起
  视频与图片放在一起
  音频放在一起
- 音频、口播、建议到达尾声使用 声音逐渐降低
- 设置导出编码，默认使用：H.264

![](/doc/7.png)