Using PEK TV
Automatic subtitles
How subtitles are found and switched on for you.
PEK TV looks subtitles up online when what you are watching has none (torrent streams, bare files). Nobody needs an OpenSubtitles account: one shared account lives in the cloud worker (see cloud/DEPLOY.md, "Subtitles").
How it behaves #
- A few seconds after playback starts, if the file has no subtitle track of its own, the best match is downloaded and switched on. A short message on the picture says what was chosen. Files that already have subtitles are left alone.
- The subtitle button (CC) always offers "Find subtitles online..." to see the other matches (release name, language, trusted uploader, hearing-impaired, auto-translated) and pick one by hand.
- Settings > Subtitles: automatic on/off and the language.
- The daily OpenSubtitles download limit is shared by everyone, so the worker stores every subtitle it downloads and serves it to all later users for free, and caps new downloads per day and per person.
Where things are #
- cloud/worker.js /v1/subs/search, /v1/subs/get (shared account, D1 cache, daily limits)
- backend/subtitles.h local routes /api/subtitles/search, /fetch, /cache/
.srt (forwards to the worker) - flutter_ui/lib/src/subtitles.dart release-name parsing, client, SRT handling, the per-player controller
- flutter_ui/lib/src/settings_extra.dart Settings > Subtitles
- flutter_ui/lib/src/player.dart subtitle menu entry, on-screen message
- Android: MpvController.addSubtitle + PekAndroid.mpvAddSubtitle (mpv sub-add)