Skip to main content

Automated subtitles fetching

Project description

SubGrab - Command-line Subtitles Downloader:


A utility which provides an ease for automating media i.e., Movies, TV-Series subtitle scraping from multiple providers.



  • Current Version: 1.0.4


pip install subgrab



Providers Supported:

Following sites can be used for subtitle downloading:

Supported Sites
ALLSUBDB (default for directories)



subgrab [-h] [-d directory path] [-m Name of the movie/season] [-s Silent Mode]
                   [-c Number of Subtitles to be downloaded] [-l Custom language]


  -h, --help            Show this help message and exit.

  -d DIR, --dir DIR     Specify directory to work in.

  -m MOVIE_NAME [MOVIE_NAME ...], --movie-name MOVIE_NAME [MOVIE_NAME ...]
                        Provide Movie Name.

  -s, --silent          Silent mode.

  -c COUNT, --count COUNT
                        Number of subtitles to be downloaded.

  -l LANG, --lang LANG  Change language.


subgrab                             # To run in current working directory.

subgrab -m Doctor Strange           # For custom movie subtitle download.

subgrab -m Doctor Strange -s        # Silent mode (No prompts i.e., title selection [if not found]).

subgrab -d "DIRECTORY_PATH"         # For specific directory.

subgrab -m The Intern 2015 -s -l AR # Language specified (First two characters of the language).

subgrab -m The Intern 2015 -c 3 -s  # Download 3 subtitles for the movie.



  • (For Windows) To use it from the context menu, paste subtitle.bat file in "shell:sendto" (By typing this in RUN). Taken from Manojmj subtitles script.


  • Two Mode (CLI and Silent inside individual media downloading [-m]) - CLI mode is executed when the title (provided i.e. media name) is not recognized by the site. Mostly when year is not provied (when two or more media names collide). Silent mode is usually executed when year is provided in the argument. Optional, you can also specify silent mode argument - which forces to download subtitles without title selection prompt. The media argument (-m) followed by the silent mode (-s) argument forces silent mode.

  • Subtitles count argument added which allows you to download multiple subtitles for an individual media. This is useful when the exact match is not found and you can download multiple srt files and check them if they are in sync with the media file (integrated in v0.12).

  • Added multiple languages support (v0.12).

  • Allows you to download subtitles for movies by specifying movie name and year (optional).

  • Allows you to download subtitles for media files in a specified directory.

  • Cross-platform (Tested on Linux and Windows).

  • Logs generation on script execution (v0.15)

  • Added Support for the SubDb (v0.16), now first preference for downloading subtitles is SubDB in downloading subtitles from a directory.

  • Initial release (v1.0.0)


  • <input type="checkbox" checked="" disabled="" /> Adding support for more languages.
  • <input type="checkbox" checked="" disabled="" /> Adding flags.
  • <input type="checkbox" checked="" disabled="" /> Support for AllSubDB .
  • <input type="checkbox" disabled="" /> Support for OpenSubtitles, YifySubtitles.
  • <input type="checkbox" disabled="" /> Auto-Sync subtitle naming with the media file when downloaded from subscene.
  • <input type="checkbox" disabled="" /> A GUI box which creates a dialogue box (consisting of tick and cross), which waits for the user to check if the subtitle downloaded is synchronized with media file or not - if clicked cross, downloads another subtitle (Process gets repeated unless, correctly synchronized).
  • <input type="checkbox" disabled="" /> Watch-folder feature (runs as a service). # Useful for movies automatically downloaded on servers.
  • <input type="checkbox" disabled="" /> Argument handling (Replace Argsparse with Click).
  • <input type="checkbox" disabled="" /> Using Tabulate for monitoring directory subtitle downloading progress. Three Columns [#, Movie_Folder, Status].
  • <input type="checkbox" disabled="" /> Better Logging.
  • <input type="checkbox" disabled="" /> Download subtitles for movies contained in a directory of X year.
  • <input type="checkbox" checked="" disabled="" /> Adding silent mode for downloading subtitles.
  • <input type="checkbox" checked="" disabled="" /> Adding CLI mode for manually downloading subtitles.
  • <input type="checkbox" checked="" disabled="" /> Implement Logging.
  • <input type="checkbox" checked="" disabled="" /> Implementation for seasons episodes.
  • <input type="checkbox" checked="" disabled="" /> Different search algorithms implementation for precise results.
  • <input type="checkbox" checked="" disabled="" /> Improving CLI Mode by displaying the menu according to the site.
  • <input type="checkbox" disabled="" /> Multiple subtitle language support also associated with the count variable.
For example:
>>> subgrab -m Doctor Strange -s -l AR, EN, SP -c 3
should download 3 subtitles for each language specified
  • <input type="checkbox" disabled="" /> An option to print list of movies which has subtitles.
  • <input type="checkbox" disabled="" /> Creating options in context menu.
  • <input type="checkbox" disabled="" /> Display menu which enables to download subtitles for selected directories. (Supporting ranges)
For Examples:
(0) Movie 1
(1) Movie 2
(10) Movie 10
(Interactive Prompt)
> 1-3, 6,7,10

will download subtitles for the directories specified.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for subgrab, version 1.0.4
Filename, size File type Python version Upload date Hashes
Filename, size subgrab-1.0.4-py3-none-any.whl (11.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size subgrab-1.0.4.tar.gz (12.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page