subliminal
Automatic subtitle downloader for videos
TLDR
Download subtitles for video
SYNOPSIS
subliminal [--provider auth] download [-l lang] [-p provider] [options] paths
DESCRIPTION
subliminal automatically downloads subtitles for video files by searching multiple online providers simultaneously. It uses video file hashing to accurately identify content, matching the exact release version for well-synchronized subtitles rather than relying solely on filename matching.
The tool queries multiple subtitle providers including OpenSubtitles, Addic7ed, Podnapisi, and others, increasing the likelihood of finding subtitles. If one provider fails, it falls back to others automatically. Languages are specified using ISO 639-1 codes, and multiple languages can be requested in a single command.
Subliminal can recursively scan entire directories to process media libraries in batch. It skips videos that already have subtitles unless forced to re-download. Provider authentication can be configured for access to premium subtitle sources with higher download limits.
PARAMETERS
download
Download subtitles.-l, --language LANG
Language code.-p, --provider NAME
Subtitle provider.-f, --force
Force re-download.-a, --age AGE
File age filter.-d, --directory DIR
Output directory.-e, --encoding ENC
Subtitle encoding.
PROVIDERS
opensubtitles - OpenSubtitles.org
addic7ed - Addic7ed
podnapisi - Podnapisi
thesubdb - TheSubDB
tvsubtitles - TVSubtitles
CAVEATS
Some providers need accounts. Rate limits apply. Not all videos have subtitles.
HISTORY
Subliminal is a Python library and CLI for subtitle downloading. It simplifies finding and downloading subtitles for video files.