MagiaTimeline 1.1.0-beta.7 自动打轴工具下载与上手说明

MagiaTimeline 这款软件能解决什么问题

做翻译字幕的朋友应该都体会过手动打轴的痛苦——对着视频一帧一帧地标记时间点，费时又费眼。MagiaTimeline 是一款基于图像分析的开源自动打轴软件，它的核心工作就是把生成的字幕时间轴与原视频的字幕帧精确对齐。软件自带自动样式分类和文字提取，能处理彩色字幕和抖动特效，输入视频后直接输出 ASS 格式字幕文件。适合油库里解说、VOICEROID 剧场、动漫短剧等内容的翻译和字幕制作场景。该版本即下即用，不需要独立显卡就能跑，原生支持多语言，打轴速度最高可以达到视频播放速度的两倍以上。

MagiaTimeline 安装包获取方式

为了方便大家下载，我已经给大家整理好了资源。资源链接放在下面，自取就好，如果链接失效，可以在评论区留言，我看到了会及时更新。

下载途径：夸克网盘夸克网盘下载以及 GitHub 发布页面（需要网络代理访问）。

文件名说明：Windows 免安装版（推荐）为 MagiaTimeline-1.1.0-beta.7+win_amd64.zip，另有源代码包 MagiaTimeline-1.1.0-beta.7.zip 可供选择。

MagiaTimeline 的安装与配置步骤

Windows 免安装版（推荐）

1. 先把下载好的软件压缩包解压到本地目录。
2. 图形界面版：双击运行 MagiaTimeline-GUI.exe，在界面中调整字幕框区域后开始处理，运行结束后会在源视频所在目录下自动生成命名好的 ass 格式时间轴文件。
3. 命令行版：把视频文件放到解压后的文件夹中，并改名为 src.mp4；双击 MagiaTimeline.exe 运行，结束后会生成名为 MagiaTimelineOutput.ass 的输出文件。

源代码安装方式

1. 下载并安装 Python 3.12.8，官方下载页面为 https://www.python.org/ 。
2. Windows 用户可优先尝试直接安装 64 位版本安装包，若安装失败再前往官网选择其他版本。
3. 下载时务必选择 64 位（64-bit）版本的 Python。
4. 安装过程中第一步需要勾选“Add Python to PATH”选项。
5. 解压源代码压缩包。
6. 双击运行代码目录中的 install.bat 脚本完成依赖安装（Linux 或 macOS 用户请改用 install.sh 脚本）。
7. 注意不要以管理员模式运行安装脚本。
8. 将视频放入代码目录并改名为 bg.mp4。
9. 图形界面版：使用 Python 运行 MagiaTimeline-GUI.py，调整字幕区域后运行，结束后会生成 MagiaTimeline_output.ass 文件。
10. 命令行版：双击 MagiaTimeline.bat 运行（Linux 或 macOS 用户运行 MagiaTimeline.sh），结束后会输出 MagiaTimeline_output.ass 文件。

MagiaTimeline 使用注意事项

默认配置只检测屏幕底部四分之一的区域，因为屏幕上方可能存在背景文字干扰。如果视频字幕位置高于下四分之一屏幕，需要打开 config.yml 文件，在 dtd:→default: 部分找到 dialogRect: 参数进行调整。config.yml 位于安装包或源代码包的根目录下，可以通过记事本或代码编辑器打开编辑，修改后记得保存。

常见问题

问：为什么生成的 ass 时间轴在压制后会出现整体偏移一帧的情况？

答：时间轴在 Aegisub 中可能显示为精确对齐，但使用其他压制软件时可能因项目帧率与源视频不一致而出现系统性偏移，需要确保压制软件的项目帧率与视频源完全一致。

问：在 60 帧或更高帧率的视频中，时间轴无法对齐怎么办？

答：ASS 格式的时间戳只保留两位小数，高帧率下可能出现无法对齐的情况，MagiaTimeline 支持输出 SRT 格式，其时间戳为三位小数，可以解决该问题，但 SRT 不支持样式设置，自动样式分类结果仅在 ASS 输出中体现。

问：MagiaTimeline 的授权使用范围是怎样的？

答：本项目基于 GNU 通用公共许可证第三版（GPLv3）授权，可自由用于商业或非商业目的，并允许复制、修改和分发，但衍生代码须遵循相同许可证发布。若在视频制作中使用本软件，建议在简介中注明“自动打轴：MagiaTimeline”。