Analysis updated 2026-05-18
Automatically find and download Chinese subtitles while watching a video in PotPlayer.
Search subtitles manually by title when automatic file name cleanup fails.
Match TV show episodes by season and episode number in the file name.
Fall back to a second subtitle source when the first one has no results.
No build step, copy two files into PotPlayer's plugin folder through its options menu.
This project is a plugin for the PotPlayer video player on Windows that automatically searches for and downloads matching subtitle files while a video is playing. It is built specifically around Japanese adult video (JAV) file naming conventions, though the underlying subtitle search works from any video file name. When you play a video, the plugin cleans up the file name by removing website prefixes, file extensions, and quality tags like 1080p or 4K, then uses that cleaned title to search SubtitleCat.com, a free public subtitle website that needs no account or API key. Starting with version 3.0, it also searches a second subtitle source, results from which are labeled with a Chinese marker meaning "Xunlei" in the results list, and downloads keep working from whichever source responds even if the other source is unavailable or has no match. Chinese subtitles, simplified or traditional, are preferred automatically, falling back to any available subtitle file if no Chinese version exists. The plugin also recognizes TV show season and episode numbers in file names, for example matching a file called Show.Name.S01E02.mkv to a search for "Show Name S01E02". A manual search option lets you type a title yourself when the automatic name cleanup does not produce good results, which is common for files with generic names like disc image dumps. The plugin includes a lookup table covering more than 90 languages, with 27 of the most common ones selectable directly in PotPlayer's interface. Installation involves downloading two files, a script file written in ActionScript and an icon file, then copying them into PotPlayer's online subtitle search plugin folder through the player's options menu. No compiling or building is required since the plugin is a single script file with no external dependencies. The project is released under the MIT license and credits an earlier subtitle plugin project it was built on top of, along with the SubtitleCat website for providing free subtitle data.
A lightweight PotPlayer plugin that auto-detects a playing video's title and downloads matching Chinese subtitles from two online sources, tailored to Japanese adult video file naming.
Mainly AngelScript. The stack also includes ActionScript, PotPlayer Plugin API.
MIT license: use, modify, and share freely, including commercially, as long as you keep the copyright notice.
Setup difficulty is rated easy, with roughly 5min to a first successful run.
Mainly general.
This repo across BitVibe Labs
Verify against the repo before relying on details.