Skip to content

Releases: DravenH/crispasr-potplayer

v1.2.0 — 人声分离 + 组件独立修复 + ffmpeg 固定版 + 断点续传

Choose a tag to compare

@DravenH DravenH released this 24 Sep 14:29

本版本主要是安装器的改动:人声分离可选前置、组件独立检测修复、ffmpeg 换固定版镜像、断点续传;垫片(whisper-faster.exe)新增 vocals=1 支持。

人声分离(抗 BGM)

  • 垫片支持 shim.ini 里 vocals=1:先用 mel-band-roformer 把人声从背景音里分离出来再转录,BGM 重的视频识别率明显改善,代价是多一遍处理时间。
  • 安装器 GUI 里对应一个默认关闭的勾选项(模型 ≈436MB,上游只发布 f16);勾选会连带下载 ffmpeg 并在 shim.ini 写入 vocals=1,命令行用 /sep。

重跑安装器 = 修复

  • 运行时 / 模型 / shim.ini 三件事每次运行各自独立检查,互不遮蔽——不会因为 CrispASR 版本正确就跳过后两步。
  • 组件"是否已就位"按实测判定(先比大小、再核内置 SHA-256),不是看目录非空;已就位的绝不重复下载,弹窗与日志会列出到底缺什么。
  • 误删模型、把 CrispASR\models\ 改名、shim.ini 里路径挪动过,重跑一次即可修好;shim.ini 只重写已经失效的键,你自己写的值和注释不动。
  • 垫片同样:shim.ini 里的模型路径指向不存在的文件时回退到自动探测,不再直接失败。
  • 需要把已通过校验的组件一起重装时加 /force。

ffmpeg:换固定版 + 两端校验

  • 不再从 gyan.dev 的滚动 zip 下载(国内实测 ~900 B/s,而且原回退地址前缀加错了等于没加)。改为 gyan 官方 6.1.1 essentials 构建、由 ffmpeg-static 以 .gz 重发布的同一份内容:npmmirror 首选 → GitHub 走 gh-proxy → gyan.dev 仅作最后兜底。
  • 下载体积 115MB → ≈56MB,.gz 和解出的 .exe 两端都核 SHA-256(本机实测两者合计约 5 秒落盘);ffprobe 改为尽力获取,拿不到不再让整步失败(crispasr 只调用 ffmpeg)。

断点续传

  • 半截文件以 <名>.part 留在原地:同一源的下次尝试、下一个镜像、下一次运行安装器都用 HTTP Range 接着传。取消或断线后重跑不必从头再来(本机实测每 300 秒被掐一次线的情况下连续 4 次续传有效)。
  • 只有在结果会被 SHA-256 校验时才跨源拼接;没有校验值可比的下载(gyan 兜底、/version:latest)换源时丢弃重来,不混两种内容。
  • 某源持续 15 秒低于 10 KB/s 会主动放弃、换下一个源,不再干等。

其它

  • 安装器与伪装出的 whisper-faster.exe 统一使用新的应用图标(窗口与任务栏)。
  • 覆盖引擎目录里不是本项目产物的 exe 前会先备份,不再只按文件名猜。
  • 修复:旧版本每次改写 shim.ini 的键都会多攒出一层换行(编辑器里表现为每条之间多一个空行),现已幂等;已有这种空行的安装,重跑一次安装器即会压平。
  • shim.ini.example 精简(41 行 → 27 行)。

安装:下载 CrispASR-PotPlayer-Setup.exe 双击运行(PotPlayer 装在 Program Files 时右键以管理员身份运行)。
国内直连慢可走 https://gh-proxy.org/https://github.com/DravenH/crispasr-potplayer/releases/download/v1.2.0/CrispASR-PotPlayer-Setup.exe

全部内置校验值见 README 的「版本与校验值」一节,可自行比对。

v1.1.0 — 固定版本 + SHA-256 校验

Choose a tag to compare

@DravenH DravenH released this 24 Sep 05:10

本版本改动的是安装器如何决定下载哪个 CrispASR,垫片本身未变。

  • 安装器不再默认跟随"最新版":固定下载已验证的上游 v0.8.36,
    每个文件下载后核对内置 SHA-256,不匹配则重下一次、仍不过就中止,
    不会解压安装未通过校验的内容。模型按 HuggingFace 的 LFS oid(即文件 sha256)校验。
  • 需要升级时显式开启:GUI 弹框勾选"检查最新版",或命令行 /version:latest / /version:v0.8.37
    (这两条路径没有可比对的哈希,因此不校验)。
  • 修复:重装 CrispASR 运行时不再连带删除 CrispASR\models\ 里已下载的模型(原先会白白重下 642MB)。
  • 全部内置校验值见 README 的「版本与校验值」一节,可自行比对。

安装:下载 CrispASR-PotPlayer-Setup.exe 双击运行(PotPlayer 装在 Program Files 时右键以管理员身份运行)。
国内直连慢可走 https://gh-proxy.org/https://github.com/DravenH/crispasr-potplayer/releases/download/v1.1.0/CrispASR-PotPlayer-Setup.exe

v1.0.1 — 文档与许可声明(安装器同 v1.0.0)

Choose a tag to compare

@DravenH DravenH released this 24 Sep 04:34

文档为主的版本:补充第三方许可致谢、免责说明与 SmartScreen 提示。
安装器二进制与 v1.0.0 完全相同(本版本无代码改动),仍可直接下载运行。

本次变更

  • 新增 第三方许可与致谢 表格:CrispASR(MIT)、NVIDIA parakeet-tdt_ctc-0.6b-ja 及其
    GGUF 转换版(CC-BY-4.0)、silero VAD、ffmpeg(GPL-3.0)、PotPlayer(专有免费软件),
    并说明本仓库不含任何第三方二进制/权重,安装器仅引导用户从官方源自行下载
  • 顶部新增 非官方项目声明:与 PotPlayer / CrispASR / NVIDIA 无关联、无背书
  • 新增 免责说明:转录受版权内容的合规责任由使用者承担;默认下载上游最新版且不校验哈希;
    软件按"现状"提供
  • 故障排查新增 SmartScreen / 杀软误报 处理指引(安装器未做代码签名,属正常现象,
    附自行核对哈希与手动部署的替代路径)

下载

CrispASR-PotPlayer-Setup.exe(约 44 KB,单文件安装器,无需 Python / 无需 clone)
国内直连慢时可走代理:
https://gh-proxy.org/https://github.com/DravenH/crispasr-potplayer/releases/download/v1.0.1/CrispASR-PotPlayer-Setup.exe

用法、静默参数与退出码见 v1.0.0 说明或仓库 README。

v1.0.0 — CrispASR for PotPlayer 安装包

Choose a tag to compare

@DravenH DravenH released this 23 Sep 21:22

把 CrispASR + NVIDIA parakeet-tdt-0.6b-ja(日语 GGUF)接入 PotPlayer 内置的『声音生成字幕』。

下载并运行

下载 CrispASR-PotPlayer-Setup.exe(约 44 KB,单文件安装器,无需 Python / 无需 clone 仓库),双击运行即可。
国内直连 GitHub 慢时可走代理:
https://gh-proxy.org/https://github.com/DravenH/crispasr-potplayer/releases/download/v1.0.0/CrispASR-PotPlayer-Setup.exe

安装器会做什么

  1. 自动定位 PotPlayer 安装目录(注册表 + 常见路径,32/64 位四种主程序名都认),找不到时弹目录选择框
  2. 把垫片写入 Engine\Whisper-Faster\;若该槽位已有你下载的官方 whisper-faster 引擎,自动改名 whisper-faster.real.exe 备份,绝不删除
  3. 未检测到 CrispASR 时可自动下载全部组件:用 nvidia-smi 读显卡计算能力预选版本(RTX 50 系→CUDA13,更早 N 卡→CUDA12,A/Intel 卡→Vulkan,无独显→CPU),弹框里可手动改;模型 q8_0(≈642MB,推荐)或 f16(≈1190MB);ffmpeg 可选
  4. shim.ini 按安装目录自动写好全部路径,全程不需要手动编辑配置文件

装完重启 PotPlayer,播放影片 →『声音生成字幕』→ 引擎选 Whisper-Faster。

命令行 / 静默安装

CrispASR-PotPlayer-Setup.exe /quiet "X:\Path\To\PotPlayer"          :: 只装垫片
CrispASR-PotPlayer-Setup.exe /quiet "X:\..." /download              :: 按显卡自动选版下载组件
... /download /build:cuda13 /model:f16 /only:crisp+model            :: 精确指定

退出码:0 成功 / 2 未找到 PotPlayer / 3 写入失败 / 4 下载失败

环境要求

  • Windows x64,.NET Framework 4.5+(Win10/11 自带)
  • NVIDIA 显卡走 CUDA 构建需对应 CUDA 运行库;无独显可用 CPU 构建
  • PotPlayer 装在 Program Files 等受保护目录时,右键安装器 → 以管理员身份运行

性能参考

RTX 5090 / CUDA 构建,2 小时 27 分电影(283MB WAV):约 36 秒完成,≈246× 实时。

详细原理、批量转录脚本 tools\transcribe-ja.ps1、故障排查见仓库 README。