1.0.0 更新日志

• 支持文豪与炼金术师剧情视频

• 更新部分依赖与安装脚本

简介

基于视频嵌入式字幕图像分析的自动打轴软件，可以广泛用于油库里解说、Voiceroid剧场、动漫短剧等各种有内嵌字幕的视频。字幕颜色不同、大小不同、位置不同均可兼容。输入视频，输出ass空轴文件。

安装简单，无需显卡，无需调参，与原字幕同步精确度高（不出错误基本完全同帧出入），打轴速度快（视频播放速度的两倍左右）。

项目主页

https://github.com/HurryPeng/MagiaTimeline

安装包下载

下载途径

• 腾讯微云（推荐）：https://share.weiyun.com/C8kODIiv

• 中国移动云盘：https://caiyun.139.com/m/i?145CFGoW7QnuE

  • 提取码：SnfO

  • 如果用Google Chrome打不开链接，换一个浏览器就好了

• GitHub：https://github.com/HurryPeng/MagiaTimeline/releases

  • 需要梯子

文件名

• Windows免安装版（推荐）：MagiaTimeline-1.0.0+win_amd64.zip

• 源代码：MagiaTimeline-1.0.0.zip

基础教程

预备工作

1. 打开文件扩展名（后缀名）显示

   1. 教程：网页链接​

   2. 如过跳过这一步，后续可能会遇到各种“找不到文件”问题

   3. 关于扩展名的扩展知识：网页链接​

Windows免安装版

1. 解压软件包

2. 把视频放进文件夹，改名为src.mp4

3. 双击MagiaTimeline.exe运行，运行结束后会输出MagiaTimelineOutput.ass

源代码安装

1. 下载安装Python 3.12.6，官网链接：https://www.python.org/

   1. Windows用户可以首先尝试安装这个https://www.python.org/ftp/python/3.12.6/python-3.12.6-amd64.exe，如果不行再上官网尝试其他版本

   2. 如果你决定自己上官网下载，请一定注意要下载64位（64-bit）的Python，并且不要下载Python 3.13或者更高版本，目前有一个依赖库（PaddleOCR）不支持

   3. 安装第一步记得勾上Add xxx to PATH

   4. 教程：网页链接​

   5. 如果你用Linux我相信你自己会

2. 解压代码包

3. 双击代码的install.bat安装（如果是Linux/苹果请改用install.sh）

   1. 不要用管理员模式运行

4. 把视频放进文件夹，改名为src.mp4

5. 双击MagiaTimeline.bat运行（如果是Linux/苹果请改用MagiaTimeline.sh），运行结束后会输出MagiaTimelineOutput.ass

   1. 不要用管理员模式运行

常见问题

以下部分操作涉及修改配置文件config.yml。config.yml在安装包/源代码包的根目录下，可以右键通过记事本或者各种代码编辑器打开，修改完请记得保存。

启用全屏字幕检测

默认配置仅检测屏幕底部四分之一区域，因为屏幕上方可能会有文字干扰字幕检测。如果你的视频字幕会高于下四分之一屏，请打开config.yml，在bcs:→default:部分找到dialogRect:参数，将0.75改为0.00。

黑白灰字幕检测

如果你的视频的字幕是黑白灰的，默认配置可能会有比较多错漏。因为一般视频画面上的黑白灰面积通常比较大，会干扰检测，MagiaTimeline默认会降低纯灰度颜色的优先级，但这个特性可能反而会影响正常黑白灰字幕。如果你想关掉这个特性，请打开config.yml并找到bcs:→default:，找到maxGreyscalePenalty: 0.70并改成0.00。

视频编辑器不支持ass格式字幕

MagiaTimeline目前仅支持输出ass格式字幕，如果你使用的视频编辑器不支持导入ass格式字幕（比如Pr），可以找在线ass转srt网站转换后导入（比如https://lab.sorz.org/tools/asstosrt/?lang=zh-cn）。

完整说明请参考README以及config.yml内的注释。

开源协议

本项目基于 GNU 通用公共许可证第三版 (GPLv3) 授权。你可以将本软件用于商业或非商业目的，并可自由复制、修改和分发，但必须遵守 GPLv3 的相关条款，并使用相同的许可证发布衍生代码。若在视频制作中使用本软件，请在简介中注明“自动打轴：MagiaTimeline”。本软件不提供任何形式的担保，包括可用性、正确性等。

已知问题与1.1版本开发计划

已知问题

• 抖动特效字幕准确度低

• 彩虹特效字幕准确度低

• 黑白灰字幕容易受干扰

• 字幕与背景颜色相近时容易受干扰

1.1版本开发计划

• 支持抖动特效字幕

• 支持彩虹特效字幕

• 支持打字机特效字幕（二游常见对话样式）

• 修复各种颜色干扰问题

• 支持字幕内容识别（OCR）

• 支持字幕颜色识别与样式自动分类

• 加速打轴

极简版本号科普

1.0.0-rc.1 < 1.0.0-rc.2 < 1.0.0 < 1.0.1 < 1.1.0-beta.1 < 1.1.0-rc.1 < 1.1.0 < 1.1.1

• 不带后缀：正式版（测试充分，质量稳定）

• rc后缀：预发布版（功能基本稳定，处于测试期）

• beta后缀：开发版（激进新功能开发，可能漏洞较多）

1.1版本发布后会出教学视频，有请大家多多支持！