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

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 setup.py and code modularized
• Can retrieve subtitles for partially downloaded files (*.part, *.temp, *.tmp)

Install

You can install it using pip:

$ pip3 install --user subdivx-download

or the development version:

$ pip3 install --user -U git+https://github.com/mgaitan/subdivx-download.git

Usage

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

Changelog

0.6 (2020-06-06)

• use guessit to parse the filename
• fix scraping the link by getting it from subtitle's detail page.

0.5 (2019-04-23)

• Changed best matching algorithm by a simpler [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 smarter.py

• Update smarter.py. [p4bloch]

• Merge branch 'master' of https://github.com/nqnwebs/subdivx.com- 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 setup.py. [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]