CLI¶
subliminal¶
Not using any configuration file.
Usage: subliminal [OPTIONS] COMMAND [ARGS]...
Subtitles, faster than your thoughts.
Options:
-c, --config FILE Path to the TOML configuration file.
[default: /home/docs/.config/subliminal/subl
iminal.toml]
--cache-dir DIRECTORY Path to the cache directory. [default:
/home/docs/.cache/subliminal]
Providers configuration:
--addic7ed USERNAME PASSWORD Addic7ed configuration.
--opensubtitles USERNAME PASSWORD
OpenSubtitles configuration.
--opensubtitlescom USERNAME PASSWORD
OpenSubtitles.com configuration.
Refiners configuration:
--omdb APIKEY OMDB API key.
--debug Print useful information for debugging
subliminal and for reporting bugs.
--version Show the version and exit.
--help Show this message and exit.
Commands:
cache Cache management.
download Download best subtitles.
Suggestions and bug reports are greatly appreciated:
https://github.com/Diaoul/subliminal/
subliminal download¶
Not using any configuration file.
Usage: subliminal download [OPTIONS] PATH...
Download best subtitles.
PATH can be an directory containing videos, a video file path or a video
file name. It can be used multiple times.
If an existing subtitle is detected (external or embedded) in the correct
language, the download is skipped for the associated video.
Options:
-l, --language LANGUAGE Language as IETF code, e.g. en, pt-BR (can
be used multiple times). [required]
-p, --provider [addic7ed|gestdown|napiprojekt|opensubtitles|opensubtitlescom|opensubtitlescomvip|opensubtitlesvip|podnapisi|tvsubtitles]
Provider to use (can be used multiple
times).
-r, --refiner [hash|metadata|omdb|tmdb|tvdb]
Refiner to use (can be used multiple times).
-a, --age AGE Filter videos newer than AGE, e.g. 12h,
1w2d.
-d, --directory DIR Directory where to save subtitles, default
is next to the video file.
-e, --encoding ENC Force subtitle file encoding, default is
utf-8.
--original-encoding Preserve original subtitle file encoding.
-s, --single Save subtitle without language code in the
file name, i.e. use .srt extension. Do not
use this unless your media player requires
it.
-f, --force Force download even if a subtitle already
exist.
-hi, --hearing-impaired Prefer hearing impaired subtitles.
-m, --min-score INTEGER RANGE Minimum score for a subtitle to be
downloaded (0 to 100). [0<=x<=100]
-w, --max-workers INTEGER RANGE
Maximum number of threads to use.
[1<=x<=50]
-z, --archives / -Z, --no-archives
Scan archives for videos (supported
extensions: .rar). [default: z]
-v, --verbose Increase verbosity.
--help Show this message and exit.
subliminal cache¶
Not using any configuration file.
Usage: subliminal cache [OPTIONS]
Cache management.
Options:
--clear-subliminal Clear subliminal cache. Use this ONLY if your cache is
corrupted or if you experience issues.
--help Show this message and exit.