1.1.0-beta.3 更新日志

• 自动编号命名输出文件（如src#20250609a.ass）

• 增加文字提取功能（OCR）（支持简体中文、繁体中文、英文、日文，无需手动选择语言，同画面多语言混合出现亦可）

• 加速打轴（包括异步写入磁盘缓存、对静态字幕跳过抖动字幕对齐步骤等性能优化）

• 升级依赖的PaddleOCR到3.0版本（新版本不知为何更慢，把加速的效果还回去了）

• 自动设置ass分辨率为输入视频的分辨率

开发版/正式版选择建议

最新开发版（1.1.0-beta.3）：推荐首先尝试。有图形界面；支持的字幕样式更多；通常错轴更少；支持文字提取；目前打轴速度稍慢于正式版；未经长期测试，软件漏洞可能更多。

最新正式版（1.0.0）：可以在开发版出现问题时作为备选项使用。无图形界面；打轴速度稍快；经过长期测试，软件漏洞更少。

简介

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

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

项目主页

https://github.com/HurryPeng/MagiaTimeline

安装包下载

下载途径

• 腾讯微云：https://share.weiyun.com/C8kODIiv

• 夸克网盘：https://pan.quark.cn/s/f11ce9c506a6

• GitHub（需要梯子）：https://github.com/HurryPeng/MagiaTimeline/releases

文件名

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

• 源代码：MagiaTimeline-1.1.0-beta.3.zip

基础教程

预备工作（仅命令行版需要）

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

   1. 教程：网页链接​

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

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

Windows免安装版（图形界面版和命令行版）

1. 解压软件包

2. 图形界面版：双击MagiaTimeline-GUI.exe，调整字幕框并运行，结束后会输出MagiaTimelineOutput.ass

3. 命令行版：把视频放进文件夹，改名为src.mp4；双击MagiaTimeline.exe运行，结束后会输出MagiaTimelineOutput.ass

源代码安装（图形界面版和命令行版）

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

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

   2. 如果你决定自己上官网下载，请一定注意要下载64位（64-bit）的Python

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

   4. 教程：网页链接​

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

2. 解压代码包

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

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

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

5. 图形界面版：用Python运行MagiaTimeline-GUI.py，调整字幕框并运行，结束后会输出MagiaTimelineOutput.ass

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

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

常见问题

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

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

“错一帧”问题

MagiaTimeline力求在Aegisub中做到时间轴与原字幕一帧不差的对齐，但在用其他软件压制时可能会系统性地出现错一帧现象。请首先保证压制软件的项目帧率与源视频严格一致（例如排除29.97与30帧的差异）。另外由于ass格式的秒数只保留两位小数，在60或者更高帧率的视频上有可能出现任何ass时间轴都无法对齐的现象。MagiaTimeline有计划支持输出srt格式（秒数为三位小数），以期解决高帧率视频时间轴错一帧的问题。

启用全屏字幕检测（命令行版）

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

启用全屏字幕检测（图形界面版）

无需修改config.yml，在图形界面中拖拽字幕框调整轴即可。

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

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

开源协议

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

1.1版本开发计划

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

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

• 支持srt格式输出

• 加速打轴

极简版本号科普

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.0正式版发布后会出教学视频，有请大家多多支持！