subdl2

Subtitle File Downloader


Keywords
subtitle, subtitles, srt, subrip, kmplayer, fix, download, multimedia, video
License
MIT
Install
pip install subdl2==1.0.1

Documentation

subdl2

subdl2 is a simple python command line tool to download subtitle files for videos and tv series.

REQUIREMENTS

Python version >= 2.7

INSTALLATION

Using pip

pip install subdl2
# or
sudo pip install subdl2

or the usual way

download any of these and extract to a folder:

then do this

$ cd subdl2_folder
$ python setup.py install
# or
$ sudo python setup.py install

USAGE

subdl2 (-h | --help)
subdl2 (-v | --version)
subdl2 --list-langs
subdl2 <video_title>|<folder_name>|<file_name> [--lang=<language>]

NOTE(s):
  * -h or --help flag is used to show this help messages.
  * -v or --version flag is used to show the currently installed version of subdl2.
  * --list-langs flag is used to see a full list of supported language.
  * if a folder name is passed, it will download subtitles for all available video files inside of that folder.
    if a file name is passed, it will download subtitle for only that file.
    if argument does not match any folder or a file's name, it will be considered as video title and subdl2 will try to download a subtitle matching that title.
  * --lang is optional and is used to define the language (e.g --lang=Spanish or --lang=13). default is English. for a list of supported languages, please refer to SUPPORTED_LANGUAGES.txt
  * subtitle files will be downloaded to current working directory.

example:

$ subdl2 "movie_name year quality" --lang=Spanish
[Success] Destination file: E:\movie_name.year.quality.spa.srt
[Success] Subtitle downloaded successfully.

Tip: When you search for a subtitle, try to include not only the movie name, but the release year and quality of that video (e.g 1080p/720p). In this way, you'll have a better chance to find the perfect subtitle for your video file.

ISSUES

Please report an issue here: https://github.com/m3zbaul/subdl2/issues

CONTRIBUTING

Contributions are always welcomed, refer to https://github.com/m3zbaul/subdl2/pulls to make a pull request.