视频进度条生成器

声明：本项目的基础版本由 B站用户 样样松s 编写。本仓库版本在原版基础上进行了功能增强和 macOS 适配。

功能更新

本版本在原版基础上新增/优化了以下功能：

1. 新增 macOS M系列芯片专属封装版本
2. 计时精度从秒级升级为帧级，时间格式统一为 HH:MM:SS:FF
3. 支持导入视频边播放边添加章节
4. 上线字体替换测试功能
5. 导入视频将自适应高度、字号与时间参数
   • 如导入 3840 宽视频，字幕条高 180、字号 56
6. 新增视频直封能力（后续将补位位置调整功能）
7. 支持自定义生成视频存储路径
   • 导入视频后输出文件名默认为「原视频名+进度条.mp4」

下载说明

Windows 版本

下载 win.zip，解压后运行 视频进度条生成器.exe

macOS 版本

下载 -macOS-v1.0.0.zip，解压后将 视频进度条生成器.app 拖入应用程序文件夹

运行（源码）

pip install -r requirements.txt
python app_webview.py  # 桌面窗口版本

注意：因底层调整，原网页版已无法直接在浏览器运行。

原版功能

• 生成静态/动态进度条图片
• 生成进度条动画视频
• 拖拽导入视频
• GIF 标记动画
• 空格键控制视频播放/暂停

技术栈

层级	技术选型
后端框架	Flask 3.x
图像处理	Pillow (PIL)
视频处理	FFmpeg
前端框架	原生 HTML/CSS/JavaScript
视频播放器	Video.js 8.x
桌面封装	pywebview
构建工具	PyInstaller

字体

程序会按这个顺序读取字体：

1. 环境变量 FONT_PATH
2. static/ 目录下的第一个 .ttf/.otf/.ttc
3. static/fonts/ 目录下的第一个 .ttf/.otf/.ttc
4. Pillow 默认字体

FFmpeg

默认优先使用当前 Python 环境中 imageio-ffmpeg 提供的 FFmpeg，不需要单独在系统里安装 FFmpeg。

时间格式

• 255：255 秒
• 4:15：4 分 15 秒
• 1:04:15：1 小时 4 分 15 秒
• 00:01:01:08：1 分 1 秒 8 帧（帧级精度）

GIF 标记

程序支持在进度条动画上添加 GIF 标记效果：

内置 GIF

程序内置了几个 GIF 标记：

• 箭头
• 脉冲圆
• 芙芙
• 闪光点
• 鸵鸟

自定义 GIF

你可以上传自定义 GIF 文件。程序会使用 custom_gifs/ 目录下的 GIF 文件。

上传后可以在设置面板的 "GIF 标记" 下拉菜单中选择使用。