get_subtitles
Finds and loads subtitles for the playing video from OpenSubtitles, choosing a hash-synced match when one exists, otherwise the most-downloaded subtitle for the title.
Instructions
Find and load subtitles for the playing video from OpenSubtitles, in one step. Picks the best match: a subtitle synced against this exact file if one exists (checked by file hash, so the timing is correct), otherwise the most-downloaded subtitle for the title. Prefer this over generate_subtitles when the video is a released film or show — a human-made subtitle is more accurate and arrives in a second rather than minutes. Requires the user's own OpenSubtitles API key in the opensubtitles_api_key setting; it fails with instructions if unset. Costs one of the user's limited daily downloads, so do not call it repeatedly.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "get_subtitles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | No | Video to match against. Defaults to the playing file. | |
| load | No | Load the subtitle into the player after downloading (default true) | |
| query | No | Search text. Omit to derive a title from the playing file's name. | |
| languages | No | Comma-separated OpenSubtitles language codes, e.g. "zh-CN,en". Defaults to the opensubtitles_languages setting, else English. |