Skip to main content

A command line tool to download the best matching subtitle from

Project description

A fork of Michel Peterson's Retrieve the best matching subtitle (in spanish) for a show episode from

This fork simplify the way to use a stand-alone program, allowing give a path (a filename or directory) as unique parameter and also changed the algorithm to find the "best match" subtitle.

Also added these features:

  • Unpack rared subtitles beside zipped ones
  • Rename subtitles after unpack it
  • Packaging. pip installable and code modularized
  • Can retrieve subtitles for partially downloaded files (*.part, *.temp, *.tmp)


You can install it using pip:

$ pip3 install --user subdivx-download

or the development version:

$ pip3 install --user -U git+


usage: subdivx [-h] [--quiet] [--skip SKIP] [--force] path

positional arguments:
  path                  file or directory to retrieve subtitles

optional arguments:
  -h, --help            show this help message and exit
  --quiet, -q
  --skip SKIP, -s SKIP  skip from head
  --force, -f           override existing file

.. tip::

    Run ``subdivx`` before ``tvnamer`` to give more metadata
    in your subtitle seach


0.5 (2019-04-23)

  • Changed best matching algorithm by a simpler <the one that contains more metadata values in description> [Martin Gaitan]
  • Cleanup. exclude results not matching the title. [Martin Gaitan]

0.4 (2017-08-25)

  • Gitignore. [Martin Gaitan]

  • Still alive. [Martin Gaitan]

  • Force flag. [Martín Gaitán]

  • Merge pull request #1 from p4bloch/master. [Martín Gaitán]


  • Update [p4bloch]

  • Merge branch 'master' of subtitle-retriever. [Martín Gaitán]

  • Log storage handled automatically (workaround to no permission issue when it's installed as system package) [Martín Gaitán]

  • Epic copy&paste fix. [Martín Gaitán]

  • Added --skip parameter. [Martín Gaitán]

  • Readme updates. [Martín Gaitán]

  • Can retrieve subtitles for partially downloaded videos (with extension .part, .temp or .tmp) [Martín Gaitán]

  • Rename after unpack. better readme. tag 0.2.2. [Martín Gaitán]

  • More robustness on extra meta data. [Martín Gaitán]

  • Version 0.2.1. [Martín Gaitán]

  • Now the argument could be a directory. retrieve a subtitle for each video there if doesn't exist. [Martín Gaitán]

  • Changed url to this fork. [Martín Gaitán]

  • Tag version in [Martín Gaitán]

  • Use tvnamer and some simple parsing to retrieve the best matching subtitle for an episode filename. Instead of many mandatory argument now you can pass just the filename of your video. [Martín Gaitán]

  • Packaging and spliting into a lib and executable. [Martín Gaitán]

  • Unpack rared subtitles with external tool unrar. [Martín Gaitán]

  • Better logging information. [Michel Peterson]

  • A little bit of pythonification. [Michel Peterson]

  • Respect import ordering. [Michel Peterson]

  • Removed debugging lines. [Michel Peterson]

  • Get_subtitle_archive(...) renamed to get_subtitle(...) [Michel Peterson]

  • Removed newlines at eof. [Michel Peterson]

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 subdivx-download, version 0.5
Filename, size File type Python version Upload date Hashes
Filename, size subdivx_download-0.5-py3-none-any.whl (6.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size subdivx-download-0.5.tar.gz (6.2 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 Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page