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 и локальной моделью перевода поверх него, чтобы создавать живые двуязычные субтитры.
Как его запустить?Скачайте установщик (TransubPlayer--win-x64-setup.exe) или портативный zip (TransubPlayer--win-x64.zip) на странице Releases на GitHub или GitCode, запустите его, пройдите мастер первоначальной настройки, а затем откройте видео или перетащите его в окно.
Нужно ли скачивать модели отдельно?Да — при первом использовании приложение предложит скачать модель распознавания речи Whisper и модель перевода Hy-MT, для чего нужно подключение к интернету; после этого подготовленный контент можно смотреть офлайн.
Живые субтитры такие же аккуратные, как готовые файлы субтитров?Нет — цель в том, чтобы субтитры были «понятными и легко читаемыми», а не уровня релиза; они немного отстают от картинки, поскольку создаются на лету, а если перевод ещё не готов, приложение показывает субтитры на языке оригинала.
Нужна ли дискретная видеокарта или он работает на любом ПК с Windows?Работает только в Windows 10/11 (64-бит); ускорение на GPU необязательно (выбирается автоматически или вручную), и без дискретной видеокарты приложение работает нормально.
Может ли он воспроизводить и записывать сетевые видеопотоки, а не только локальные файлы?Да — он может открывать распространённые URL сетевых потоков напрямую, а записать поток на локальный диск можно в один шаг, чтобы посмотреть позже.
Что будет, если для видео уже есть файл субтитров?Если рядом с видео лежит файл субтитров с таким же именем, он загружается автоматически в первую очередь, а вернуться к живым субтитрам можно в любой момент.
Чем это отличается от инструмента Transub?Transub Player предназначен для просмотра видео с живыми субтитрами, которые достаточно хороши для просмотра; сопутствующий инструмент Transub создаёт готовые к публикации китайские субтитры, полностью очищенные и прошедшие проверку качества.
Какие горячие клавиши управляют режимом субтитров во время просмотра?Нажмите 1 для перевода, 2 для оригинала или 3 для двойных субтитров, используйте Z/X для сдвига тайминга субтитров и V, чтобы показать или скрыть субтитры.
Автор
dlsandy
Размер
2 MB
Звёзды
1.1K
Возраст
2 мес
Коммиты · 90 дней