Repolode
Submit
fancydirty

fancydirty/subtitle-scout

A self-hosted subtitle system where an LLM agent finds, verifies, and installs subtitles for your media library, and translates when no source exists.

View on GitHubWebsite
Stars
126
Forks
3
Open issues
0
Last commit
2 months ago

What is it?

Subtitle Scout scans media folders directly, identifies each title through TMDB, and checks which episodes or movies are missing subtitles in the target language. An LLM agent then chooses among sources such as OpenSubtitles, SubDL, ASSRT, Jimaku, and SubHD, and judges whether each downloaded candidate belongs to the exact episode before writing it next to the video file.

Candidates are downloaded into a throwaway sandbox and checked structurally, including cue count, timeline span against runtime, and encoding. If no source has a usable subtitle, a second agent can translate the source subtitle sentence by sentence after a glossary pass. Unmatched episodes stay marked as unmatched rather than receiving a likely-wrong file.

It runs as a Docker container with a web dashboard and a setup wizard, stores credentials in its own SQLite database, and does not require Plex, Jellyfin, Emby, Sonarr, or Radarr. Chinese has the deepest source coverage; English, Japanese, and Korean are fully supported.

Key features

  • 01Scans local media folders directly without a media server.
  • 02Uses an LLM agent to choose sources and search terms.
  • 03Verifies each candidate structurally in a sandbox before installing it.
  • 04Translates sentence by sentence when no source subtitle exists.
  • 05Shows per-episode status for installed, pending, and unavailable subtitles.
  • 06Provides a web dashboard with activity history and a setup wizard.

Use cases

  • Filling in Chinese subtitles for a home media library on a NAS.
  • Finding subtitles for less common shows that single sources often miss.
  • Translating a Japanese subtitle into Chinese when no Chinese track exists.

Topics

#subtitles#llm-agent#self-hosted#docker#subtitle-translation#tmdb#media-library#ai-agent#chinese-subtitles#llm

FAQ

What is subtitle-scout?
A self-hosted subtitle system where an LLM agent finds, verifies, and installs subtitles for your media library, and translates when no source exists. Subtitle Scout scans media folders directly, identifies each title through TMDB, and checks which episodes or movies are missing subtitles in the target language. An LLM agent then chooses among sources such as OpenSubtitles, SubDL, ASSRT, Jimaku, and SubHD, and judges whether each downloaded candidate belongs to the exact episode before writing it next to the video file.
Is subtitle-scout free to use? What license does it have?
subtitle-scout is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is subtitle-scout still maintained?
Updated within 6 months. The last commit to subtitle-scout was on Sep 4, 2026.
What can I use subtitle-scout for?
Filling in Chinese subtitles for a home media library on a NAS. Finding subtitles for less common shows that single sources often miss. Translating a Japanese subtitle into Chinese when no Chinese track exists.
Where can I get subtitle-scout?
The source code and installation instructions are on GitHub: https://github.com/fancydirty/subtitle-scout

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects