subdx-dl 1.7.4

A command line tool to download the best matching subtitle from subdivx.com

Subdx-dl

A cli tool for download subtitle from www.subdivx.com with the better possible matching results.

Install

pip install -U subdx-dl

Special case installing on Termux (Android) for first time

pkg install python-lxml && pip install -U subdx-dl

For testing use a virtual env and install it there

For linux:

mkdir subdx
python3 -m venv subdx
source subdx/bin/activate
git clone https://github.com/Spheres-cu/subdx-dl.git
cd subdx-dl
pip install -e .

For Windows:

mkdir subdx
python -m venv subdx
.\subdx\Scripts\activate
git clone https://github.com/Spheres-cu/subdx-dl.git
cd subdx-dl
pip install -e .

Usage

usage: sdx-dl [-h or --help] [optional arguments] search

positional arguments:

search                  file, directory or movie/series title or IMDB Id to retrieve subtitles

optional arguments:

  -h, --help             show this help message and exit

Download:
  --path PATH, -p PATH    Path to download subtitles
  --quiet, -q             No verbose mode
  --verbose, -v           Be in verbose mode
  --force, -f             override existing file
  --no-choose, -nc        No Choose sub manually
  --no-filter, -nf        Do not filter search results
  --proxy PROXY, -P PROXY Set a http(s) proxy connection

Search by:
  --Season, -S                    Search for Season
  --keyword KEYWORD, -k KEYWORD   Add keyword to search among subtitles
  --title TITLE, -t TITLE         Set the title of the show

IMDB search:
  Search in IMDB by ID or title
  --search-imdb, -si    Search first for the IMDB id or title
  --imdb IMDB, -i IMDB  Search by IMDB id

Information:
  --version, -V         Show program version
  --check-version, -cv  Check for new version

Examples

Search a single TV-Show by: Title, Season number or simple show name:

sdx-dl "Abbott Elementary S04E01"

sdx-dl "Abbott Elementary 04x01"

sdx-dl "Abbott Elementary"

or search for complete Season:

sdx-dl -S "Abbott Elementary S04E01"

Search for a Movie by Title, Year or simple title, even by IMDB ID :

sdx-dl "Deadpool and Wolverine 2024"

sdx-dl "Deadpool 3"

sdx-dl tt6263850

Search by a file reference:

sdx-dl Harold.and.the.Purple.Crayon.2024.720p.AMZN.WEBRip.800MB.x264-GalaxyRG.mkv

sdx-dl --imdb tt13062500 -q The.Walking.Dead.Daryl.Dixon.S02E06.480p.x264-RUBiK.mkv

Search by IMDB id regardless filename, search strings keeping the serie season/number and in quiet mode.

Search first for the IMDB ID or correct tv show Title if don't know they name or it's in another language:

sdx-dl --search-imdb "Los Caza fantasmas"

sdx-dl -si "Duna S1E3"

• IMDB search:

Tips

• Always try to search with Title, Year or season number for better results.

• Search by filename reference.

  Search in this way have advantage because the results are filtered and ordered by the metadata of the filename.

• Try to pass the IMDB ID of the movie or TV Show.

• Pass keywords (--keyword -k "<str1 str2 str3 ...>") of the subtitle you are searching for better ordered results.

• If the search not found any records by a single chapter number (exe. S01E02) try search by the complete Seasson with --Seasson -S parameter.

• If you don't wanna filter the search results for a better match and, instead, improved response time use --no-filter -nf argument.

• Very important!: You need to be installed some rar decompression tool for example: unrar (preferred), unar, 7zip or bsdtar. Otherwise, subtitle file will do not decompress.

Some Captures

• Performing search:

• Navigable searches results:

• Subtitle description:

• User comments: