Booker786/ArknightsProgressBarPlugin
1
1
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions

2 releases 2 tags

RSS feed
  • v2026.7.27 5572c6db37

    v2026.7.27 Stable

    Booker786 released this 2026-07-27 00:59:55 +00:00 | 0 commits to master since this release

    ArknightsProgressBar 发布说明

    v2026.7.26

    首个功能完整版本。把 prts.wiki 导出的单个循环小人动画（WebM），一键合成为一条
    带透明的进度条 .mov 视频素材，拖进 DaVinci Resolve（或其他支持 ProRes 4444 的
    剪辑软件）上层轨道即可：视频从头放到尾时，小人从画面左下角走到右下角，配合
    循环行走动画直观表示进度。已打包为免安装独立 exe，不再内置 ffmpeg
    （运行时自动检测系统 ffmpeg，没有则一键下载），双击即用。

    网盘下载

    功能特性

    • WebM → ProRes 4444 预合成：根据目标视频的宽/高/帧率/时长，把单个循环动作
      合成为一条完整进度条素材（透明通道，像素格式 yuva444p12le）。无需 Resolve 任何
      脚本、关键帧或 Loop 设置。
    • 自动抠黑底：prts.wiki 导出的 WebM 多为不透明黑底（无 alpha 通道），软件会自动
      把近黑背景抠成透明，消除人物周围的「黑色正方形」。
    • 自动裁剪留白：自动检测内容包围盒并裁剪四周空白，让小人填满画面、从最左走到最右，
      而不是停在中间留白区域。
    • 独立 exe（免安装、体积小）：通过 build.py 用 PyInstaller 打包；不再内置
      ffmpeg      （避免 300MB+ 臃肿）。运行时自动检测系统 ffmpeg，没有则一键下载到本机
      缓存目录，无需用户手动配置 PATH。
    • 关于对话框与项目链接：菜单「帮助 → 关于」内含 GPLv3 协议声明、项目仓库与个人
      主页直达链接，保证分发后他人能找回项目。
    • 自定义图标：使用指定的角色图片作为窗口与 exe 文件图标。

    使用步骤（三步）

    1. 在 prts.wiki 打开角色页 → 基建/战斗动画 → 导出 WebM
      （普通版或带透明通道均可，软件会自动处理黑底）。
    2. 打开本软件，选择该 WebM，填写目标视频的 宽 / 高 / 帧率 / 时长，按需调整
      人物高度(%)、底边距、左右边距，点击「生成进度条 mov」。
    3. 把生成的 *_progressbar.mov 拖到剪辑软件的上层视频轨道，对齐到画面底部即可。

    构建 / 打包

    仓库不含打包后的 exe（体积很小，约 45 MB）。如需自行打包：

    python -m venv .venv
.venv\Scripts\python.exe -m pip install -r src/gui/requirements.txt pyinstaller
.venv\Scripts\python.exe build.py
# 产物：dist/ArknightsProgressBar.exe（不含 ffmpeg，运行时自动检测/下载）

    打包时已通过 --exclude-module 排除本工具用不到的 PySide6 子模块
    （QtQuick/QML、WebEngine、Multimedia、3D、Charts、Pdf 等），把体积从约
    240 MB 压到约 45 MB；如需完整 Qt 可去掉这些排除项重新打包。

    版权

    已知限制

    • exe 本身很小（约几十 MB）。首次在无 ffmpeg 的电脑上运行时会按需下载 ffmpeg
      （约几十 MB，存于 %LOCALAPPDATA%/ArknightsProgressBar/ffmpeg/bin），之后无需重复下载。
    • 进度条长度默认占满画面宽度；如需保留左右边距，在软件中设置对应百分比即可。

    更新记录

    • v2026.7.26 — 首个完整版本：WebM→ProRes 进度条、自动抠黑底+裁剪、独立 exe、关于
      对话框与图标。
    • v2026.7.27 — 不再内置 ffmpeg（运行时自动检测/一键下载）；PySide6 通过
      排除未用子模块瘦身，exe 体积由约 240 MB 降至约 45 MB。
    Downloads
  • v2026.7.26 4b3b1d5646

    v2026.7.26 Stable

    Booker786 released this 2026-07-26 13:03:47 +00:00 | 3 commits to master since this release

    ArknightsProgressBar 发布说明

    v2026.7.26

    首个功能完整版本。把 prts.wiki 导出的单个循环小人动画（WebM），一键合成为一条
    带透明的进度条 .mov 视频素材，拖进 DaVinci Resolve（或其他支持 ProRes 4444 的
    剪辑软件）上层轨道即可：视频从头放到尾时，小人从画面左下角走到右下角，配合
    循环行走动画直观表示进度。已打包为免安装独立 exe，自带 ffmpeg，双击即用。

    功能特性

    • WebM → ProRes 4444 预合成：根据目标视频的宽/高/帧率/时长，把单个循环动作
      合成为一条完整进度条素材（透明通道，像素格式 yuva444p12le）。无需 Resolve 任何
      脚本、关键帧或 Loop 设置。
    • 自动抠黑底：prts.wiki 导出的 WebM 多为不透明黑底（无 alpha 通道），软件会自动
      把近黑背景抠成透明，消除人物周围的「黑色正方形」。
    • 自动裁剪留白：自动检测内容包围盒并裁剪四周空白，让小人填满画面、从最左走到最右，
      而不是停在中间留白区域。
    • 独立 exe（免安装）：通过 build.py 用 PyInstaller 打包，ffmpeg/ffprobe 一并
      打入 exe，无需用户另行安装 ffmpeg 或配置 PATH。
    • 关于对话框与项目链接：菜单「帮助 → 关于」内含 GPLv3 协议声明、项目仓库与个人
      主页直达链接，保证分发后他人能找回项目。
    • 自定义图标：使用指定的角色图片作为窗口与 exe 文件图标。

    使用步骤（三步）

    1. 在 prts.wiki 打开角色页 → 基建/战斗动画 → 导出 WebM
      （普通版或带透明通道均可，软件会自动处理黑底）。
    2. 打开本软件，选择该 WebM，填写目标视频的 宽 / 高 / 帧率 / 时长，按需调整
      人物高度(%)、底边距、左右边距，点击「生成进度条 mov」。
    3. 把生成的 *_progressbar.mov 拖到剪辑软件的上层视频轨道，对齐到画面底部即可。

    构建 / 打包

    仓库不含打包后的 exe（体积较大）。如需自行打包：

    python -m venv .venv
.venv\Scripts\python.exe -m pip install -r src/gui/requirements.txt pyinstaller
$env:FFMPEG_BIN_DIR = "你的\ffmpeg\bin目录"
.venv\Scripts\python.exe build.py
# 产物：dist/ArknightsProgressBar.exe

    版权

    已知限制

    • 打包后的 exe 体积较大（约 300MB+），因为内嵌了完整 ffmpeg；如介意可改用系统 PATH 中的
      ffmpeg 重新打包（修改 build.py 去掉 --add-binary）。
    • 进度条长度默认占满画面宽度；如需保留左右边距，在软件中设置对应百分比即可。

    更新记录

    • v2026.7.26 — 首个完整版本：WebM→ProRes 进度条、自动抠黑底+裁剪、独立 exe、关于
      对话框与图标。
    Downloads