A video player focused on subtitle-related features such as dual subtitles, AI-generated subtitles, real-time OCR, real-time translation, word lookup, and more!
LLPlayer-demo.mp4
TED Talk - The mind behind Linux
LLPlayer has many features for language learning that are not available in normal video players.
- Dual Subtitles: Two subtitles can be displayed simultaneously. Both text subtitles and bitmap subtitles are supported.
- AI-generated subtitles (ASR): Real-time automatic subtitle generation from any video and audio, powered by OpenAI Whisper. 99 languages are suported!
- Real-time Translation: Supports Google and DeepL API, 134 languages are currently supported!
- Real-time OCR subtitles: Can convert bitmap subtitles to text subtitles in real time, powered by Tesseract OCR and Microsoft OCR.
- Subtitles Sidebar: Both text and bitmap are supported. Seek and word lookup available. Has anti-spoiler functionality.
- Instant word lookup: Word lookup and browser searches can be performed on subtitle text.
- Customizable Browser Search: Browser searches can be performed from the context menu of a word, and the search site can be completely customized.
- Plays online videos: With yt-dlp integration, any online video can be played back in real time, with AI subtitle generation, word lookups!
- Flexible Subtitles Size/Placement Settings: The size and position of the dual subtitles can be adjusted very flexibly.
- Subtitles Seeking for any format: Any subtitle format can be used for subtitle seek.
- Built-in Subtitles Downloader: Supports opensubtitles.org
- Integrate with browser extensions: Can work with any browser extensions, such as Yomitan and 10ten.
- Customizable Dark Theme: The theme is based on black and can be customized.
- Fully Customizable Shortcuts: All keyboard shortcuts are fully customizable. The same action can be assigned to multiple keys!
- Built-in Cheat Sheet: You can find out how to use the application in the application itself.
- Free, Open Source, Written in C#: Written in C#/WPF, not C, so customization is super easy!
TED Talk - The mind behind Linux
[OS]
- Windows 10 x64, Version 1903 later
- Windows 11 x64
[Pre-requisites]
- .NET Desktop Runtime 9
- If not installed, a installer dialog will appear
- Microsoft Visual C++ Redistributable Version >= 2022 (for Whisper ASR, Tesseract OCR)
- Note that if this is not installed, the app will launch, but will crash when ASR or OCR is enabled!
-
Download builds from release
-
Launch LLPlayer
Please open LLPlayer.exe.
- Open Settings
Press CTRL+. or click the settings icon on the seek bar to open the settings window.
- Download Whisper Model for ASR
From Subtitles > ASR section, please download Whisper's models.
You can choose from a variety of models, the larger the size, the higher the load and accuracy.
Note that models with En endings are only available in English.
Audio Language allows you to manually set the language of the video (audio). The default is auto-detection.
- Download Tesseract Model for OCR (optional)
If you want to use OCR for bitmap subtitles, please download Tesseract's Model. (You can also use Microsoft OCR.)
From Subtitles > OCR section, you can download Tesseract models.
Note that there is a model for each language.
- Set Translation Target Language (optional)
To use the translation function, please set your native language. This is called the target language.
The source language is detected automatically.
From Subtitles > Translate section, please set the Target Language at the top.
The default translation engine is Google Translate.
You can change it to DeepL from the settings below, but you will need to configure API key. (free for a certain amount of use)
- Place
yt-dlp.exeto project (optional)
If you want to play online videos such as Youtube, please place yt-dlp.exe in your project.
There is currently no downloader in the application. You can download it from the following.
https://github.com/yt-dlp/yt-dlp/releases/
Please place it in the following path.
Plugins/YoutubeDL/yt-dlp.exe
- Play any videos with subtitles!
You can play it from the context menu or by dropping the video.
If yt-dlp is installed, you can also play it by pasting the URL with CTRL+V (or from context menu).
There are two CC buttons on the bottom seek bar.
The left is the primary subtitle and the right is the secondary subtitle. Please set your learning language for the primary subtitle and your native language for the secondary subtitle.
Adding external subtitles is done in the same way as for videos, either by dragging or from the context menu.
- Open CheatSheet
You can open a built-in CheatSheet by pressing F1 or from ContextMenu.
All keyboard and mouse controls are explained. Keyboard controls are fully customizable from the settings.
Status: Beta
It has not yet been tested by enough users and may be unstable.
Significant changes may be made to the UI and settings.
I will actively make breaking changes during version 0.X.X.
(Configuration files may not be backward compatible when updated.)
- Clone the Repository
$ git clone git@github.com:umlx5h/LLPlayer.git- Open Project
Install Visual Studio or JetBrains Rider and open the following sln file.
$ ./LLPlayer.sln- Build
Select LLPlayer project and then build and run.
Guiding Principles for LLPlayer
- Be a specialized player for language learning, not a general-purpose player
- So not to be a replacement for mpv or VLC
- Support as many languages as possible
- Provide some language-specific features as well
-
Improve core functionality
-
ASR
- Enable ASR subtitles with dual subtitles (one of them as translation)
- Pause and resume
- More natural sentence splitting (try echosharp?)
-
Subtitles
- Customize language preference for primary and secondary subtitles, respectively, and automatic opening
- Enhanced local subtitle search
- Export ASR/OCR subtitle results to SRT file
-
-
Stabilization of the application
-
Allow customizable mouse shortcuts
-
Documentation / More Help
- Support for dictionary API or for specific languages (English, Japanese, ...)
- Dedicated support for Japanese for watching anime.
- Word Segmentation Handling
- Incorporate Yomitan or 10ten to video player
- Text-to-Speech integration
- More translation engine such as local LLM
- Support translation as plugin?
- Cross-Platform Support using Avalonia (Linux / Mac)
- Context-Aware Translation
- Word Management (reference to LingQ, Language Reactor)
- Anki Integration
Contributions are very welcome! Development is easy because it is written in C#/WPF.
If you want to improve the core of the video player other than language functions, LLPlayer uses Flyleaf as a core player library, so if you submit it there, I will actively incorporate the changes into the LLPlayer side.
https://github.com/SuRGeoNix/Flyleaf
I may not be able to respond to all questions or requests regarding core player parts as I do not currently understand many of them yet.
For more information for developers, please check the following page.
https://github.com/umlx5h/LLPlayer/wiki/For-Developers
LLPlayer would not exist without the following!
In implementing LLPlayer, I used the Flyleaf .NET library instead of libmpv or libVLC, and I think it was the right decision!
The simplicity of the library makes it easy to modify, and development productivity is very high using C#/.NET and Visual Studio.
With libmpv and libVLC, modifications on the library side would be super difficult.
The author has been very helpful in answering beginner questions and responding very quickly.
Flyleaf comes with a sample WPF player, and I used quite a bit. Thank you very much.
Subtitle generation is achived by OpenAI Whisper, whisper.cpp and its binding whisper.net. LLPlayer simply uses these libraries to generate subtitles. Thank you for providing this for free!
- Sicos1977/TesseractOCR : For Tessseract OCR
- MaterialDesignInXAML/MaterialDesignInXamlToolkit : For UI
- searchpioneer/lingua-dotnet : For Language Detection
- sskodje/WpfColorFont : For Font Selection
Browser Extension for Netflix. LLPlayer is mainly inspired by this with its functionality and interface. (Not enough functionality yet, though).
AI subtitle generation (ASR) and OCR subtitles are all performed locally.
Therefore, no network communication occurs at all.
However, the model needs to be downloaded only once for the first time, and this is the only place where network communication occurs.
Network communication is required when using the translation function, but this is an optional feature, so it is possible to choose not to communicate at all.
Your privacy is fully guaranteed because it is free and OSS.
By default, only the CPU is used to generate subtitles.
Setting Threads to 2 or more from the ASR settings may improve performance.
Note that setting it above the number of CPU threads is meaningless.
If your machine is equipped with a NVIDIA or AMD GPU, you can expect even faster generation by enabling CUDA or Vulkan from the Hardware Options in the ASR settings.
Certain runtimes may require a toolkit to be installed in advance. See the link below for details.
https://github.com/sandrohanea/whisper.net?tab=readme-ov-file#runtimes-description
The available ones will be used in order of priority from the top. Note that changing the hardware options settings will require a restart.
You can translate words, but cannot currently look up dictionaries.
I plan to support the dictionary API in the future, but is not currently supported because it is difficult to support a lot of languages.
Instead, you can copy selected words to the clipboard. Certain dictionary tools can monitor the clipboard and search for words.
For English-English dictionaries, LDOCE5 Viewer is highly recommended.
Currently not available within the video player, but you can send subtitle text to your browser via the clipboard. Thus, you can check the meaning of words with any browser extension such as Yomitan, 10ten.
A little preparation is required, please check following page.
https://github.com/umlx5h/LLPlayer/wiki/Browser-Extensions-Integration
This project is licensed under the GPL-3.0 license.