本项目已经发布至 PyPI，可以通过 pip 或兼容的工具安装：
pip install MyGICA # pip 安装方式或者使用 uv 工具管理器安装（推荐）：
uv tool install MyGICA # uv 工具管理器安装方式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 # 编译器脚本（主逻辑，对应 MyGICA 命令行工具）
├── structure.py # 数据结构定义（用于解析 TOML，可以查看合法的定义）
├── time_based_cache_cleaner.py # 按时间管理缓存的工具（对应 MyGICA_cache_cleaner 命令行工具）
└── srt2MyGICA.py # 将 SRT 转为 .MyGICA.toml 的脚本框架（对应 srt2MyGICA 命令行工具）
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' # 可选，替换片段自带音频如果某段 clip 中只写了 start 或 end，脚本会自动推断另一个值以填满整个 range。
如果 ranges 之间有时间空隙，脚本会自动延续片段或插入 black 片段。
fontcolor 可以使用 colors 表中定义的别名，如 '灯' → #77BBDD。
天哪，这也太自动了！接下来就要自动生成 bug 了！
- Windows 系统 + uv 工具管理器 安装方式
winget install Gyan.FFmpeg # 安装 ffmpeg 至系统 PATH
winget install astral-sh.uv # 安装 uv 工具管理器至系统 PATH
uv tool install MyGICA # 安装 MyGICA 工具至系统 PATH- pip 安装方式
# 自行配置 FFmpeg 至系统 PATH
# 自行管理 Python 环境
pip install MyGICA编辑 示例.MyGICA.toml，填写你的项目信息、素材路径、字幕内容等。
编译项目，在 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需要安装至系统 PATH （见使用方法）
- 无需配置
- Python 3.13
- 第三方库：
dacite - 自用库
betterer（已打包）
如需技术支持，请联系项目维护者。bilibili@不死の祥云。
🎬 MyGICA —— 让视频剪辑变得简单又自动化！（并不能）