Repository navigation
Releases: DravenH/crispasr-potplayer
Release list
v1.2.0 — 人声分离 + 组件独立修复 + ffmpeg 固定版 + 断点续传
本版本主要是安装器的改动:人声分离可选前置、组件独立检测修复、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 校验
本版本改动的是安装器如何决定下载哪个 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)
文档为主的版本:补充第三方许可致谢、免责说明与 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 安装包
把 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
安装器会做什么
- 自动定位 PotPlayer 安装目录(注册表 + 常见路径,32/64 位四种主程序名都认),找不到时弹目录选择框
- 把垫片写入
Engine\Whisper-Faster\;若该槽位已有你下载的官方 whisper-faster 引擎,自动改名whisper-faster.real.exe备份,绝不删除 - 未检测到 CrispASR 时可自动下载全部组件:用
nvidia-smi读显卡计算能力预选版本(RTX 50 系→CUDA13,更早 N 卡→CUDA12,A/Intel 卡→Vulkan,无独显→CPU),弹框里可手动改;模型 q8_0(≈642MB,推荐)或 f16(≈1190MB);ffmpeg 可选 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。