MyGICA 1.0a0

剪辑 MyGICA 视频的 MyGICA 工具, MyGICA 即 MyGO!!!!! & MUJICA

MyGICA 使用文档

📄 简介

MyGICA (剪辑 MyGICA 视频的 MyGICA 工具, MyGICA 即 MyGO!!!!! & MUJICA) 是一个文本化、结构化的视频剪辑工具，用于盯帧剪辑 MyGICA 填词 / MAD 视频。简单地说，就是代码剪视频且剪辑单位为帧。

目前本项目并非 AI 项目，只是将视频剪辑流程文本化、结构化，可以作为与其他人或 AI 协作的接口，因此并不能自动剪辑。MyGICA 使用 TOML 文本作为剪辑说明，扩展名为 .MyGICA.toml，Python + FFmpeg 作为编译器。

目前发展方向有二：1、传统功能。继续优化数据结构和编译器以支持更多功能或简化使用难度。2、AI 功能。使用 AI 生成 .MyGICA.toml 文件初稿（不看好）。

MyGICA 优先实现了符合通常 MyGICA 填词 / MAD 剪辑习惯的编译器，如：先确定时间范围，再在范围内定义字幕与片段；字幕常使用应援色；默认总有 bgm 等。

解决剪映不能导出 23.976 (24000 / 1001) 帧视频（导出24帧会和预览不一致，出现闪帧）及 PR 不能导入 .mkv 视频素材的问题。

🧩 功能特性

• 自动添加字幕（drawtext 滤镜，默认有入场出场动画）
• 自动填充时间空隙（自动接续上个片段，可指定 NEXT 接续下个片段，全留空时使用 black）
• 自动补全片段起止时间（自动推断单个缺失的 start / end）
• 自动处理响度为 -2dBTP
• 支持盯帧剪辑（基于帧的时间定义）
• 支持多源素材（如 MKV、MP4 等，由 ffmpeg 支持）
• 支持字体颜色映射（用于快速使用应援色）
• 支持缓存避免重复渲染，并可以手动清理指定时长未使用的缓存
• 支持片段拼接复制模式（更快）和重新编码模式（更兼容）

---

📁 项目结构说明

project/
├── pyproject.toml         # Python 项目配置文件
├── README.md              # 本说明文档
├── LICENSE                # AGPL-3.0 许可证
├── 示例.MyGICA.toml        # 主配置文件（.MyGICA.toml 格式）
├── SC-Heavy.otf           # 字体文件（思源粗宋或其他字体）
├── cache_dir/             # 缓存目录（临时片段）
├── output_dir/          # 输出目录（最终视频）
└── src/
    ├── A_compiler.py          # 编译器脚本（主逻辑）
    ├── structure.py           # 数据结构定义（用于解析 TOML，可以查看合法的定义）
    ├── time_based_cache.py    # 按时间管理缓存的工具（可选）
    └── srt2MyGICA.py          # 将 SRT 转为 .MyGICA.toml 的脚本框架（可选）

---

🛠️ 配置文件格式说明（TOML）

全局设置

fps = '24000/1001'         # 帧率
suffix = ".mp4"            # 输出文件格式
#start = 0                 # 视频起始帧（闭区间）建议只在需要快速预览时定义以只渲染部分视频
#end = 5000                # 视频结束帧（开区间，下同）建议只在需要快速预览时定义以只渲染部分视频

源素材定义

[sources]
go1 = 'D:\path\to\mygo1.mkv'
# ...
ji13 = 'D:\path\to\mujica13.mkv'
black = 'cache_in\test_video_basic.mp4'  # 特殊 black 片段，运行 `0_gen_black.py` 生成，需要帧率等和项目一致，建议使用 black 填充未剪辑片段提交缓存利用率
bgm = 'background_music.wav'  # 背景音乐，自动合并到视频中，必选

颜色映射（用于字幕）

[colors]
'灯' = '#77BBDD'
'爱音' = '#FF8899'
# ...

时间范围定义（剪辑段）

[[ranges]]
start = 2020
end = 2098
[[ranges.texts]]
text = "火爆脾气一脚踢到钛合金"
[[ranges.clips]]
source = "go1"  # 可选 PREV 和 NEXT，表示接续上个或下个片段
start = 29590
end = 29626
[[ranges.clips]]
source = "go1"
start = 30852  # 可省略一个 start 或 end，脚本会自动补全
volume = -50
#sound = 'sound_1'  # 可选，替换片段自带音频

---

🧠 自动功能说明

1. 自动补全时间（start / end）

如果某段 clip 中只写了 start 或 end，脚本会自动推断另一个值以填满整个 range。

2. 自动填充空隙

如果 ranges 之间有时间空隙，脚本会自动延续片段或插入 black 片段。

3. 字幕颜色映射

fontcolor 可以使用 colors 表中定义的别名，如 '灯' → #77BBDD。

天哪，这也太自动了！接下来就要自动生成 bug 了！

---

🧪 示例配置

示例.MyGICA.toml

示例.MyGICA.mp4

日不落的爱音.MyGICA.toml

日不落的爱音.MyGICA.mp4

---

▶️ 使用方法

1. 准备工作

安装 ffmpeg，在 powershell 运行

winget install Gyan.FFmpeg

安装 uv，在 powershell 运行

winget install astral-sh.uv

安装 MyGICA，在 powershell 运行

uv tool install MyGICA

2. 修改配置文件

编辑 示例.MyGICA.toml，填写你的项目信息、素材路径、字幕内容等。

3. 运行脚本

编译项目，在 powershell 运行

MyGICA 示例.MyGICA.toml

输出文件将保存在 output_dir/{{project_name}}。

---

🎵 背景音乐处理

脚本会自动将背景音乐 bgm 合并到视频中：

---

🧾 输出目录结构

output_dir/
└── {{project.MyGICA.mp4}} # 最终视频
cache_in/
└── ...                    # 可选的输入素材
cache_dir/
├── seg_*.mp4              # 各段缓存片段
└── concat_list.txt        # 拼接列表

---

🧠 注意事项

• 时间单位为帧（frame）。
• 所有视频源、字体文件、bgm 等必须存在，否则报错。

---

🧰 依赖工具

• ffmpeg
• Python 3.13
• 第三方库：dacite
• 自用库 betterer（已打包）

---

📬 联系方式

如需技术支持，请联系项目维护者。bilibili@不死の祥云。

---

🎬 MyGICA —— 让视频剪辑变得简单又自动化！（并不能）