# `Laev.OpenSubtitles`
[🔗](https://github.com/alexdont/laev/blob/main/lib/laev/open_subtitles.ex#L1)

OpenSubtitles.com REST API client — search subtitles in any language and
fetch the actual .srt text.

Search needs only an API key; downloading needs a logged-in token (username +
password), and counts against your daily download quota. Config comes from
`OPENSUBTITLES_API_KEY`, `OPENSUBTITLES_USERNAME`, `OPENSUBTITLES_PASSWORD`.

# `can_download?`

# `configured?`

# `download_srt`

Download a subtitle file's .srt text by its `file_id`.

# `search`

Search subtitles. `opts` may include `:query`, `:tmdb_id`, `:season_number`,
`:episode_number`, `:languages` (comma string like "en,es").
Returns `{:ok, [%{file_id, language, release, downloads}]}` best-first.

# `srt_to_vtt`

Convert SRT text to WebVTT (browsers' `<track>` needs VTT, not SRT).

---

*Consult [api-reference.md](api-reference.md) for complete listing*