Transub-Player README

项目的 README,来自 github.com/dlsandy/Transub-Player。合并为一个 markdown 文件:README.md。

Transub Player

English | 简体中文 | 日本語 | 한국어

Open a video. Subtitles follow.

Foreign films, dramas, anime — watch first, even without a subtitle file.
Open a video and the picture appears right away; readable subtitles catch up soon after. No more hunting subtitle sites just to keep watching.

Transub Player — live dual subtitles while watching

Windows desktop player · v1.6.0
Download the installer or portable zip from GitHub or GitCode. You can also use Check for updates inside the app.


Why Transub Player

Live subtitles while you watch
Subtitles are generated on the fly with built-in speech recognition. Progress stays visible — you can tell it’s working, not hanging.

Translation · Source · Dual — one click
Casual viewing? Switch to translation. Learning? Switch to dual. If translation isn’t ready yet, source subtitles still play — watching never stops.

Chinese / Japanese / Korean / English
Change source and target languages while playing; the file name can help guess the source language. Defaults aim for “understand quickly,” with room to upgrade later.
More languages are planned.

Streams play — and record
Open common network stream URLs directly. Want to rewatch later? Record to local storage in one step.

Deep match with Transub
Generate high-quality subtitles with the Transub subtitle tool; when they’re ready, the player can prompt you to play them.


Who it’s for

For publish-ready Chinese subtitles, full cleanup, and QC, use the companion product Transub.


Download & start

  1. Get a release from GitHub Releases or GitCode Releases (or use Check for updates in the app):
    • Installer (recommended): TransubPlayer-*-win-x64-setup.exe — next, next, done
    • Portable: TransubPlayer-*-win-x64.zip — unzip and run TransubPlayer.exe
  2. If SmartScreen says Windows protected your PC, choose More info → Run anyway
  3. Finish the first-run setup wizard (you can associate common video formats)
  4. Open or drop a video; if recognition / translation models aren’t installed yet, follow the prompts — then live subtitles start

If a subtitle file already sits next to the video, it loads first; you can switch back to live subtitles anytime.
Installed builds store settings and models under %LocalAppData%\Transub Player\data\; portable builds use data\ next to the exe.

Three steps

  1. Open or drop a local video (or open a stream URL)
  2. Wait for subtitles, then watch along
  3. Switch as needed: translation / source / dual (1 / 2 / 3)

Shortcuts

Action Keys
Open Ctrl+O
Play / Pause Space · click video
Seek back / forward ← / →
Translation / Source / Dual 1 / 2 / 3
Delay / advance subtitles Z / X
Show / hide subtitles V
Playlist L
Next / Previous N / P
Fullscreen F · F11 · Enter · double-click
Screenshot S
Mute M
Exit fullscreen Esc

More options live in the context menu and Settings (UI language, file associations, subtitle look, model install, and more).


How it works

Layer Tech
Shell / UI WPF
Video mpv
Speech recognition Built-in Whisper (whisper.cpp / GGML turbo, download on demand)
Translation llama-server + Hy-MT GGUF (on demand)

Main path: open a local video → readable subtitles ASAP → translation can fall back → quit clean.


Build from source

Requires Windows + .NET SDK. First run needs network access to fetch mpv and models.

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

Pack a release (Player + mpv + embedded Whisper; model weights not included). Output goes to artifacts\pack\ (setup + portable zip; Inno Setup 6 is required to build the setup):

powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1
# Portable or setup only:
# powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1 -Target Portable
# powershell -ExecutionPolicy Bypass -File tools\pack-release.ps1 -Target Setup

First recognition: Settings → Models → download whisper turbo.


System requirements


Tips


Changelog

See CHANGELOG.md (English) · CHANGELOG.zh-CN.md · CHANGELOG.ja.md · CHANGELOG.ko.md


In one line

Open it. Watch it. Subtitles catch up.

Transub-Player (dlsandy/Transub-Player)

正在搜索数据库…

这是什么?Transub Player 是一款 Windows 视频播放器,借助内置的语音识别和翻译功能即时生成实时字幕,即使没有字幕文件,也能观看外语电影、剧集或动画。
这只是个视频播放器,还是也能翻译?它是一款独立的视频播放器,播放部分基于 mpv,并在其上叠加了内置的 Whisper 语音识别引擎和本地翻译模型,用于生成实时双语字幕。
怎样才能运行起来?从 GitHub 或 GitCode 的 Releases 页面下载安装包(TransubPlayer--win-x64-setup.exe)或便携版 zip 压缩包(TransubPlayer--win-x64.zip),运行后完成首次启动的设置向导,然后打开或拖入视频即可。
需要单独下载模型吗?需要。首次使用时,程序会提示你下载 Whisper 语音识别模型和 Hy-MT 翻译模型,这需要联网;之后,已处理好的内容可以离线观看。
实时字幕能和正式字幕文件一样精致吗?不能。它的目标是做到“能看懂、跟得上”,而不是正式发布级别的质量。由于字幕是实时生成的,会比画面略微滞后;如果翻译尚未就绪,程序会先显示源语言字幕。
需要独立显卡吗,还是任何 Windows 电脑都能运行?仅支持 Windows 10/11(64 位)。GPU 加速是可选的(可自动或手动选择),没有独立显卡时程序也能正常运行。
除了本地文件,它还能播放和录制网络视频流吗?可以。它能直接打开常见的网络流地址,还能一步把视频流录制到本地存储,方便以后回看。
如果视频已经有字幕文件,会怎样?如果视频旁边有对应的字幕文件,程序会优先自动加载;你也可以随时切换回实时生成的字幕。
它和 Transub 工具有什么区别?Transub Player 用于随便看看视频,提供实时的、够用的字幕;配套的 Transub 工具则能生成可直接发布的、经过完整清理和质检的中文字幕。
观看时用哪些快捷键控制字幕模式?按 1 切换为译文字幕,按 2 切换为原文字幕,按 3 切换为双语字幕;用 Z/X 调整字幕时间,按 V 显示或隐藏字幕。
作者
dlsandy
大小
2 MB
星标
1.1K
时长
2个月
提交 · 90 天