LLPlayer

一款专为语言学习设计的媒体播放器。

这是一款专注于字幕相关功能的视频播放器，支持双字幕、AI生成字幕、实时翻译、单词查询等强大特性！

官网 · 发布页面

---

🎬 演示

https://github.com/user-attachments/assets/05a7b451-ee3b-489f-aac9-f1670ed76e71

TED演讲 - Linux之父的心路历程

✨ 功能

LLPlayer为语言学习提供了许多普通视频播放器所不具备的功能。

• 双字幕模式： 可同时显示两组字幕。支持文本字幕和位图字幕。
• AI生成字幕（ASR）： 基于OpenAI Whisper技术，可对任何视频和音频进行实时自动字幕生成。支持whisper.cpp和faster-whisper两种引擎。
• 实时翻译： 支持多种翻译引擎，如Google、DeepL、Ollama、LM Studio、OpenAI等。
• 上下文感知翻译： 通过LLM识别字幕上下文，实现高精度翻译。
• 实时OCR字幕： 基于Tesseract OCR和Microsoft OCR技术，可将位图字幕实时转换为文本字幕。
• 字幕侧边栏： 同时支持文本和位图字幕，可进行字幕跳转和单词查询，并支持增量式字幕搜索。
• 即时单词查询： 可对字幕中的单词进行查询并直接在浏览器中搜索。
• 自定义浏览器搜索： 从单词的右键菜单即可发起浏览器搜索，且搜索网站可完全自定义。
• 播放在线视频： 集成yt-dlp，可实时播放任意在线视频，并支持AI字幕生成和单词查询！
• 灵活的字幕大小与位置设置： 双字幕的大小和位置均可自由调整。
• 兼容多种字幕格式： 任何字幕格式都可用于字幕跳转。
• 内置字幕下载器： 支持opensubtitles.org。
• 与浏览器扩展集成： 可与各种浏览器插件配合使用，例如Yomitan和10ten。
• 可定制深色主题： 主题以黑色为主，用户可进一步自定义。
• 全键盘快捷键自定义： 所有快捷键均可完全自定义，同一操作甚至可以绑定到多个按键！
• 内置使用指南： 应用程序内即提供使用说明。
• 免费开源，采用C#编写： 使用C#/WPF开发，而非C语言，因此高度易于定制！

🖼️ 截图

TED演讲 - Linux之父的心路历程

✅ 系统要求

[操作系统]

• Windows 10 x64，版本1903及以上
• Windows 11 x64

[前置条件]

• .NET桌面运行时9
  • 若未安装，将弹出安装提示框
• Microsoft Visual C++ Redistributable >= 2022版（用于Whisper ASR和Tesseract OCR）
  • 注意：若未安装，应用程序虽能启动，但启用ASR或OCR时会崩溃！

[针对Nvidia用户（RTX显卡）]

• 注：安装CUDA驱动可加速字幕渲染 CUDA 12.8（请注意，若使用Blackwell GPU或希望启用CUDA（RTX 50xx系列），则需安装此驱动）

🚀 快速上手

1. 从发布页面下载安装包

2. 启动LLPlayer

请打开LLPlayer.exe。

3. 进入设置

按下CTRL+.或点击进度条上的设置图标，即可打开设置窗口。

4. 下载Whisper模型用于ASR

在“字幕 > ASR”部分，请下载适用于whisper.cpp的Whisper模型。您可以选择不同大小的模型，模型越大，计算负载和准确度越高。

注意，带有En后缀的模型仅支持英语。

“音频语言”允许您手动设置视频（音频）的语言，默认为自动检测。

如果您想使用faster-whisper引擎代替whisper.cpp，请直接在设置中下载该引擎，无需再下载模型。使用faster-whisper时，首次选择模型会自动下载，无需提前准备。

关于各引擎的详细说明，请参阅此处。

5. 设置翻译目标语言

要使用翻译功能，您需要先设置您的母语，这称为“目标语言”。而“源语言”则会自动检测。

在“字幕 > 翻译”部分，请在顶部设置“目标语言”。

默认的翻译引擎是GoogleV1。

若您想使用其他翻译引擎，需在设置中进行配置。详细信息请参阅此处。

6. 播放带字幕的视频！

您可以通过右键菜单或直接拖放视频来播放。对于在线视频，也可以通过CTRL+V粘贴链接或从右键菜单中播放。

底部进度条上有两个“CC”按钮。

左侧为主要字幕，右侧为辅助字幕。请将主要字幕设置为您正在学习的语言，辅助字幕设置为您的母语。

添加外部字幕的方式与视频相同，可通过拖放或右键菜单完成。

7. 打开使用指南

您可以通过按F1键或右键菜单打开内置的使用指南。

其中详细介绍了所有键盘和鼠标操作。键盘操作也可在设置中完全自定义。

❤️ 开发状态

状态：Beta

目前尚未经过足够用户的测试，可能存在不稳定情况。

UI和设置可能会发生重大变化。
在0.X.X版本期间，我将积极引入破坏性变更。

（更新时，配置文件可能无法向后兼容。）

🔨 构建

1. 克隆仓库

$ git clone git@github.com:umlx5h/LLPlayer.git

2. 打开项目

安装 Visual Studio 或 JetBrains Rider，并打开以下 slnx 文件。

$ ./LLPlayer.slnx

在 Visual Studio 中，您需要提前从设置中添加对 slnx 格式的预览支持。

3. 构建

选择 LLPlayer 项目，然后进行构建并运行。

🚩 路线图

LLPlayer 的指导原则

• 成为一款专注于语言学习的播放器，而非通用型播放器
  • 因此，它不应取代 mpv 或 VLC
• 支持尽可能多的语言
• 同时提供一些针对特定语言的功能

目前

• 完善核心功能

  • ASR

    • 实现双字幕模式下的 ASR 字幕（其中一列为翻译）
    • 暂停与恢复

  • 字幕

    • 分别自定义主、副字幕的语言偏好，并实现自动开启
    • 增强本地字幕搜索功能
    • 将 ASR/OCR 字幕结果导出为 SRT 文件

• 应用程序的稳定性优化

• 允许自定义鼠标快捷键

• 文档 / 更多帮助

之后

• 支持词典 API 或特定语言（英语、日语等）
• 针对观看动漫的日语专用支持。
  • 词汇分割处理
  • 将 Yomitan 或 10ten 集成到视频播放器中
• 文本转语音集成
• 更多翻译引擎，例如本地 LLM

未来

• 使用 Avalonia 实现跨平台支持（Linux / Mac）
• 上下文感知翻译
• 单词管理（参考 LingQ、Language Reactor）
• Anki 集成

🤝 贡献

非常欢迎贡献！由于项目使用 C#/WPF 编写，开发起来十分容易。

如果您希望改进视频播放器的核心部分，而不仅仅是 UI 和语言功能，LLPlayer 使用 Flyleaf 作为核心播放库。因此，您可以直接向 Flyleaf 提交更改，我会积极将其合并到 LLPlayer 中。

https://github.com/SuRGeoNix/Flyleaf

对于核心播放器部分的问题或请求，我可能无法一一回复，因为我目前对这些内容还不够了解。

更多开发者相关信息，请查看以下页面：

https://github.com/umlx5h/LLPlayer/wiki/For-Developers

🙏 特别感谢

没有以下的支持，LLPlayer 就不会存在！

对于库

• SuRGeoNix/Flyleaf

在实现 LLPlayer 时，我选择了 Flyleaf .NET 库，而不是 libmpv 或 libVLC，我认为这是一个正确的决定！

该库设计简洁，易于修改，结合 C#/.NET 和 Visual Studio，开发效率非常高。相比之下，使用 libmpv 和 libVLC 进行库层面的修改会非常困难。

作者在解答初学者问题时给予了极大的帮助，并且响应速度非常快。

Flyleaf 自带一个 WPF 播放器示例，我从中借鉴了不少内容。非常感谢！

• openai/whisper
• sandrohanea/whisper.net
• ggerganov/whisper.cpp

字幕生成依赖于 OpenAI Whisper、whisper.cpp 及其绑定 whisper.net。LLPlayer 只是简单地调用了这些库来生成字幕。感谢你们的免费提供！

• Sicos1977/TesseractOCR：用于 Tesseract OCR
• MaterialDesignInXAML/MaterialDesignInXamlToolkit：用于 UI
• searchpioneer/lingua-dotnet：用于语言检测
• CharsetDetector/UTF-unknown：用于字符集检测
• sskodje/WpfColorFont：用于字体选择

对于应用

• Language Reactor

Netflix 浏览器扩展程序。LLPlayer 的功能和界面主要受到它的启发。 （不过目前功能还远远不够）。

❓ 常见问题解答

问：ASR、OCR 和翻译是否需要网络通信？

ASR（自动生成字幕）和 OCR 字幕均在本地完成。
因此，完全不会产生任何网络通信。

不过，模型只需在首次使用时下载一次，这也是唯一涉及网络通信的环节。

如果你选择 Ollama 或 LM Studio API，翻译功能将在本地运行。
由于它是免费且开源的，你的隐私将得到充分保障。

问：如何加快 ASR 的速度？（whisper.cpp）

默认情况下，仅使用 CPU 生成字幕。
在 ASR 设置中将“线程数”设置为 2 或更多 可能会提升性能。

请注意，将其设置为超过 CPU 线程数是没有意义的。

如果你的机器配备了 NVIDIA 或 AMD GPU，可以在 ASR 设置的“硬件选项”中启用 CUDA 或 Vulkan，以实现更快的生成速度。

某些运行时环境可能需要提前安装工具包。详情请参阅以下链接：

https://github.com/sandrohanea/whisper.net?tab=readme-ov-file#runtimes-description

可用的运行时环境会按优先级从上到下依次使用。请注意，更改硬件选项设置后需要重启程序。

问：如果我想查单词的词典释义怎么办？

目前可以翻译单词，但还无法直接查询词典。

我计划在未来支持词典 API，但由于支持多种语言较为困难，目前暂不提供此功能。

作为替代方案，你可以将选中的单词复制到剪贴板。某些词典工具可以监控剪贴板并自动查找单词。

对于英英词典，强烈推荐使用 LDOCE5 Viewer。

问：能否使用 Yomitan 或 10ten 等浏览器扩展？

目前视频播放器内尚不支持直接使用这些扩展，但你可以通过剪贴板将字幕文本发送到浏览器。
这样，你就可以使用任何浏览器扩展（如 Yomitan 或 10ten）来查看单词含义。

这需要一些准备工作，请参阅以下页面：
https://github.com/umlx5h/LLPlayer/wiki/Browser-Extensions-Integration

问：如何更新 yt-dlp.exe？

yt-dlp.exe 位于以下路径：

Plugins/YoutubeDL/yt-dlp.exe

你可以从以下网址下载最新版本的可执行文件：

https://github.com/yt-dlp/yt-dlp/releases/

如果需要更新，请下载并将其复制到指定路径即可。

问：VLC 和 LLPlayer 有什么区别？

VLC 是一款通用的媒体播放器。
相比之下，LLPlayer 具有许多特别适合语言学习的功能。

	VLC	LLPlayer
跨平台（Win、Linux、Mac）	✔️	❌
自动字幕生成	尚未支持（whisper.cpp）	✔️（whisper.cpp、faster-whisper）
实时翻译	尚未支持	✔️
本地翻译	尚未支持（SeamlessM4t?）	✔️（Ollama、LM Studio）
在线翻译	❌	✔️（Google、DeepL、OpenAI）
上下文感知翻译	❌	✔️（由 LLM 提供）
单词翻译	❌	✔️
单词查询	❌	✔️
字幕侧边栏	❌	✔️
字幕增量搜索	❌	✔️
字幕跳转	❌	✔️
双语字幕	✔️（使用不便）	✔️

问：为什么要在实时进行字幕生成和翻译？

主要原因在于懒惰。预先生成字幕非常繁琐，尤其是对于在线视频而言。
而 ASR 和翻译可以从任意播放位置开始，因此即使你只想观看视频的一部分带字幕内容，也无需等待即可立即享受。

此外，软硬件技术的进步使得 ASR 和翻译能够达到更高的准确度。

📝 许可证

本项目采用 GPL-3.0 许可证。

LLPlayer 快速上手指南

LLPlayer 是一款专为语言学习设计的媒体播放器，支持双语字幕、AI 实时生成字幕（ASR）、实时翻译、单词查询等功能。

环境准备

系统要求

• 操作系统：Windows 10 x64 (版本 1903 及以上) 或 Windows 11 x64
• 运行环境：
  • .NET Desktop Runtime 9
    • 注：若未安装，启动程序时会自动弹出安装向导。
  • Microsoft Visual C++ Redistributable Version >= 2022
    • 重要：若未安装此组件，程序可启动，但在启用 ASR (自动字幕) 或 OCR (文字识别) 功能时会直接崩溃。

硬件加速（可选）

• NVIDIA 用户 (RTX 显卡)：安装 CUDA 12.8 可显著提升字幕渲染速度。
  • 注：使用 Blackwell 架构显卡 (如 RTX 50xx 系列) 必须安装此驱动以启用 CUDA 加速。

安装步骤

LLPlayer 目前提供便携版安装包，无需复杂配置，下载即可运行。

1. 下载安装包 访问官方 Release 页面下载最新版本： https://github.com/umlx5h/LLPlayer/releases

2. 解压与运行 下载完成后解压压缩包，双击运行 LLPlayer.exe 即可启动程序。

基本使用

1. 配置 AI 字幕引擎 (ASR)

首次使用需下载 Whisper 模型以支持实时字幕生成。

• 按下 CTRL+. 或点击进度条上的设置图标打开 设置 (Settings)。
• 进入 Subtitles > ASR 选项卡。
• 在 whisper.cpp 部分下载所需的模型（模型越大，准确率越高，但资源占用也越大）。
  • 提示：以 En 结尾的模型仅支持英语。
• 音频语言：默认为自动检测，也可手动指定视频语言。
• 备选方案：若想使用 faster-whisper 引擎，请在设置中下载该引擎而非模型。使用 faster-whisper 时，选定模型会在首次运行时自动下载。

2. 配置实时翻译

• 在设置中进入 Subtitles > Translate 选项卡。
• 设置 目标语言 (Target Language) 为你的母语（例如：中文）。
• 源语言将自动检测。
• 默认翻译引擎为 GoogleV1。如需使用 DeepL、Ollama 或本地 LLM，请在此处切换并配置相应参数。

3. 播放视频与加载字幕

• 本地视频：直接将视频文件拖入窗口，或通过右键菜单打开。
• 在线视频：复制视频链接，在 LLPlayer 中按下 CTRL+V 或通过右键菜单粘贴即可播放（依赖 yt-dlp）。
• 外挂字幕：拖入字幕文件或通过右键菜单加载，操作同视频文件。

4. 使用双语字幕功能

界面底部进度条上方有两个 CC 按钮：

• 左侧 CC：主字幕（建议设置为正在学习的语言）。
• 右侧 CC：副字幕（建议设置为母语/翻译语言）。

点击对应按钮可开启/关闭字幕。你可以在设置中灵活调整双字幕的大小和位置。

5. 其他实用功能

• 单词查询：鼠标悬停或点击字幕中的单词，可进行即时查词或自定义浏览器搜索。
• 快捷键速查：按下 F1 或在右键菜单中打开内置的 CheatSheet，查看所有键盘和鼠标控制说明。
• 侧边栏：支持字幕列表浏览、跳转及增量搜索。

注意：当前版本处于 Beta 阶段，UI 和设置可能会在未来版本中发生较大变化。