Skip to main content

A python script for automating subtitles downloading.

Project description

Subtitles [Subscene] Grabber (Sub-Grab v0.13):

A script that allows you to download subtitles for TV-Series, Anime and Movies from subcene site.

Status:

  • Beta Release.

Installation:

pip install subgrab

Preview:

asciicast

Usage:

Usage:

subgrab [-h] [-d DIR] [-m MEDIA_NAME [MEDIA_NAME ...]] [-s]
                   [-c COUNT] [-l LANG]

Options:

  -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.

Examples:

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.

Features:

  • 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).

Requirements:

  • Python v2.7

  • Requests

  • Beautiful Soup

TODO:

  • [x] Adding support for more languages.

  • [x] Adding flags.

  • [ ] AllSubDB, OpenSubtitles, YIFY subtitles search.

  • [X] Adding silent mode for downloading subtitles.

  • [X] Adding CLI mode for manually downloading subtitles.

  • [ ] Adding GUI box for subtitle sync check in the media-player (in individual mode).

  • [ ] Use Logging.

  • [X] Optimize Code.

  • [X] Implementation for seasons episodes.

  • [X] Different search algorithms implementation for precise

Project details


Download files

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

Source Distribution

subgrab-0.13.zip (12.9 kB view details)

Uploaded Source

File details

Details for the file subgrab-0.13.zip.

File metadata

  • Download URL: subgrab-0.13.zip
  • Upload date:
  • Size: 12.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for subgrab-0.13.zip
Algorithm Hash digest
SHA256 9f5c43e605e806eca3fa20785a50748a84201b8c00768a567684309027f06bdd
MD5 76ce365648c307195e94d25acc3273c8
BLAKE2b-256 00e4978e8b4aa557b6ad9eadbde57764ceef43d1cae0100d978424ccf20cc8e1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page