https://github.com/umlx5h/LLPlayer
先给原始代码地址
我还是老方法,下载源码之后,丢到cursor里面去读,然后给我详细的保姆级教程。
我来为您解读一下 LLPlayer 这个专门为语言学习设计的媒体播放器。
主要功能特点:
- 双字幕显示
- 可以同时显示两种语言的字幕
- 支持文本和图像格式的字幕
- AI 自动生成字幕
- 使用 OpenAI Whisper 技术
- 支持 whisper.cpp 和 faster-whisper 两种引擎
- 实时翻译功能
- 支持多种翻译引擎:Google、DeepL、Ollama、LM Studio、OpenAI 等
- 具有上下文感知翻译功能,通过 LLM 提供更准确的翻译
- 其他实用功能
- 实时 OCR 字幕转换
- 字幕侧边栏
- 即时单词查询
- 在线视频播放支持
- 可自定义的快捷键
- 深色主题
安装步骤:
- 系统要求:
- Windows 10 x64(1903 及以上版本)或 Windows 11 x64
- 需要安装 .NET Desktop Runtime 9
- 需要安装 Microsoft Visual C++ Redistributable 2022 或更高版本
- 如果使用 NVIDIA RTX GPU,建议安装 CUDA 12.8 驱动
- 安装过程:
- 从 GitHub Releases 下载最新版本
- 运行
LLPlayer.exe
使用方法:
- 初始设置:
- 按
CTRL+.
或点击进度条上的设置图标打开设置窗口 - 在
Subtitles > ASR
部分下载 Whisper 模型 - 在
Subtitles > Translate
设置目标语言(您的母语)
- 播放视频:
- 可以直接拖放视频文件到播放器
- 可以粘贴在线视频链接(支持
CTRL+V
) - 底部有两个
CC
按钮:- 左边是主要字幕(学习语言)
- 右边是次要字幕(母语)
- 快捷键指南:
- 按
F1
打开内置的快捷键指南 - 所有快捷键都可以在设置中自定义
特别说明:
- 字幕生成(ASR)和 OCR 功能都是本地运行的,不需要网络连接
- 如果使用 Ollama 或 LM Studio API 进行翻译,翻译也是在本地完成的
- 目前处于 Beta 版本阶段,可能还不够稳定
- 支持与浏览器扩展(如 Yomitan、10ten)集成使用
这是一个非常强大的语言学习工具,特别适合需要同时对照两种语言字幕的学习者。它的实时字幕生成和翻译功能可以让您更轻松地学习任何视频内容。
指导您安装 LLPlayer
首先,让我们检查一下您的系统环境:
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"
让我们按照以下步骤进行安装:
- 第一步:安装必要的运行环境
首先需要安装 .NET Desktop Runtime 9:
- 请访问:https://dotnet.microsoft.com/en-us/download/dotnet/9.0
- 下载并安装 ".NET Desktop Runtime 9.0"
- 第二步:安装 Visual C++ Redistributable
- 请访问:https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist
- 下载并安装最新版本的 Visual C++ Redistributable
- 第三步:下载 LLPlayer
- 请访问:https://github.com/umlx5h/LLPlayer/releases
- 下载最新版本的 LLPlayer
- 第四步:安装 NVIDIA CUDA(如果您有 NVIDIA 显卡)
- 如果您使用的是 NVIDIA RTX 显卡,建议安装 CUDA 12.8
- 访问:https://developer.nvidia.com/cuda-downloads
请您先完成第一步和第二步的安装,安装完成后告诉我,我们继续后面的步骤。
安装这些基础组件时,如果遇到任何问题,请告诉我,我会帮您解决。
您现在可以开始安装 .NET Desktop Runtime 9 和 Visual C++ Redistributable 了。安装完成后,请告诉我,我们继续下一步。
关于字幕问题:
好的,这个错误提示我们需要下载 Whisper 模型。让我指导您完成字幕设置:
- 打开设置
- 按
CTRL+.
或点击进度条上的设置图标打开设置窗口
- 下载 Whisper 模型
- 在设置窗口中找到
Subtitles > ASR
部分 - 您会看到几个可选的模型,建议选择:
- 如果您主要学习英语:选择
whisper-tiny.en
或whisper-base.en
- 如果您学习其他语言:选择
whisper-tiny
或whisper-base
- 模型大小说明:
- tiny: 最小,速度最快,准确度较低
- base: 平衡选择,速度和准确度适中
- small: 较大,准确度更好
- medium: 大,准确度很好
- large: 最大,准确度最高
- 如果您主要学习英语:选择
- 启用硬件加速
- 在同一个设置页面中,找到
Hardware Options
- 由于您有 NVIDIA 显卡,建议:
- 启用
CUDA
选项 - 设置
Threads
为 2 或更高
- 启用
- 设置音频语言
- 在
Audio Language
下拉菜单中选择视频的语言 - 如果不知道,可以保持
Auto
自动检测
请您先打开设置,然后告诉我您想下载哪个模型,我会继续指导您完成后续设置。
最后,关于接入翻译的api,找api商店进行购买即可。