Transub Player：实时双语字幕播放器

项目简介

Transub Player 是一款 Windows 桌面视频播放器，定位是「打开视频，字幕自己跟上来」。它内置语音识别，播放时即时生成字幕，并可翻译成译文、原文或双语显示，适合看外语电影、剧集、动画时不想先去字幕站找字幕的场景。

界面基于 WPF，视频播放使用 mpv，语音识别使用内置 Whisper（whisper.cpp / GGML turbo，按需下载），翻译使用 llama-server + Hy-MT GGUF（按需下载）。

主要功能

• 边看边出字幕：用内置语音识别实时生成字幕，进度可见，能判断它是在工作还是卡住。
• 译文 / 原文 / 双语一键切换：随手看切译文，学习时切双语；翻译还没出来时，原文仍可继续显示，不中断观看。
• 中 / 日 / 韩 / 英：播放过程中可切换源语言和目标语言，文件名可辅助猜测源语言。
• 网络流播放与录制：可直接打开常见网络流 URL，也能一步录制到本地。
• 局域网扫码播放：从控制栏 Wi-Fi 入口进入，设置可访问文件夹，用手机浏览器选片观看；实时字幕仍由桌面端 Whisper / 翻译生成，网页上可切换译文 / 原文 / 双语 / 关，并带有访问密码引导、连接与会话状态、格式兼容提示、同文件字幕缓存复用、手机端原文/译文进度条。
• 最小化到托盘：最小化后收进系统托盘，局域网与识别继续运行；右键托盘图标可显示窗口或退出，再次打开文件会回到主窗口。
• 外挂字幕优先：视频旁已有字幕文件时会先加载，随时可切回实时字幕；匹配支持 Subs / 字幕 子目录，以及 影片.chs.srt、影片_chs.srt、影片-chs.srt 这类语言标记，GBK / GB18030 与 ASS/SSA 文件也可读入。

安装与使用

1. 从 GitHub Releases 或 GitCode Releases 获取安装包（推荐，TransubPlayer-*-win-x64-setup.exe）或便携版（TransubPlayer-*-win-x64.zip，解压后运行 TransubPlayer.exe），也可以在应用内使用 Check for updates。
2. 若 SmartScreen 提示「Windows 已保护你的电脑」，选择 更多信息 → 仍要运行。
3. 完成首次运行向导（可顺带关联常见视频格式）。
4. 打开或拖入视频；若识别 / 翻译模型尚未安装，按提示下载后即开始生成实时字幕。

三步上手：打开或拖入本地视频（或打开流 URL）→ 等字幕出现后跟着看 → 按 1 / 2 / 3 切换译文 / 原文 / 双语。

常用快捷键：Ctrl+O 打开、Space 播放/暂停、← / → 快退/快进、1 / 2 / 3 译文/原文/双语、Z / X 字幕延迟/提前、V 显示/隐藏字幕、L 播放列表、N / P 下一个/上一个、F / F11 / Enter 全屏、S 截图、M 静音、Esc 退出全屏。更多选项在右键菜单与设置里（界面语言、文件关联、字幕外观、模型安装等）。

从源码构建需要 Windows + .NET SDK，首次运行需联网获取 mpv 与模型：

powershell -ExecutionPolicy Bypass -File tools\fetch-mpv.ps1
dotnet run --project src\TransubPlayer\TransubPlayer.csproj

打包发布（Player + mpv + 内嵌 Whisper，不含模型权重），输出到 artifacts\pack\，构建安装包需要 Inno Setup 6：

powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1
# 仅便携版或仅安装包：
# powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1 -Target Portable
# powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1 -Target Setup

注意事项

• 系统要求：Windows 10 / 11（64 位）。
• 首次使用需联网下载识别 / 翻译模型，之后已准备好的内容可离线播放。
• 可选 GPU 加速（自动或手动），没有独立显卡也能使用。
• 实时生成的字幕会略微滞后于画面，这是正常现象；目标是「看得懂、跟得上」，不是发布级字幕。
• 未安装翻译模型时，原文（源语言）字幕仍可正常使用。
• 退出时播放器启动的进程会一并结束，不会在后台残留。
• 安装版把设置与模型放在 %LocalAppData%\Transub Player\data\，便携版使用 exe 旁的 data\。

---

本作品整理自 GitHub 开源项目 dlsandy/Transub-Player，原作者 @dlsandy。中文介绍由 AI 根据项目 README 整理，以原仓库为准。