LegendasTV-Downloader

Single-file script that scans a folder for videos and downloads subtitles for all of them from legendas.tv

NO user input needed, totally automatic.

Works great for TV-Shows, but not that great for movies, depending on naming schemes on both the file and legendas.tv website. It also appends the IMDB Rating to the end of a Movie's Folder.

Please, use the issues tab to make suggestions and file bugs.

Quick HowTo:

1. Install python v3.x (also supports v2.x, but 3.x is recommended)
2. Make sure UNRAR is in your PATH variable and available on console (e.g.: download from http://www.rarlab.com/rar_add.htm)
3. Open the file 'ltv-downloader.py' with any text editor to edit the initial configuration: Only your USERNAME and PASSWORD are required to be edited, other changes are optional.
4. Drag-and-Drop videos or folders on 'ltv-downloader.py' (or a shortcut of it, with extra arguments such as "-OnlyIMDBRating" to update Ratings without downloading subtitles)
5. Enjoy!

Optional arguments:

-d : Increase debug verbosity -dd : Increase debug verbosity even more -r : Recurse folders appearing after this argument -f : Force search, even if best/acceptable/no-language subtitle is already present -OnlyIMDBRating : Just add the IMDB rating to the name (Not working since API became paid: http://www.omdbapi.com/ ) -s : Silent Mode, never waits for user input to continue/exit

More details:

What it does:

The script totally automates the downloading and renaming of subtitles from legendas.tv. NO user input is required, apart from an optional final "press any key".

It accepts movies/shows files as arguments (Drag-and-dropped too). Then it analyzes the file names, searches and chooses the best subtitle from legendasTV, downloads it and renames. It also accepts folders as input, analyzing all the files inside, and recursing through all subfolders. Default settings with no arguments is to scan the current directory without recursing.

Many configurations are available for the user to choose, as explained in the Configuration section below. The default settings are suited to my typical workflow. I recommend you to read the comments on the script or look at the settings info below.

With default settings, it stores the downloaded subtitles with the language code appended (e.g. *.pt.srt). However, if a subtitles file exists without the language code, it skips that movie. Except if it's passed only one argument, one video file, in which case it always search and downloads.

---

Installation

• Download https://raw.github.com/NiJoao/LegendasTV-Downloader/master/ltv-downloader.py
• Copy it to your Series folder, or any other place you wish acessible to drag-and-drop your movies collection
• You can create shortcuts to the script in any folders you wish
• Edit the file to configure it. Read next session for more info
• Install python v3.x

Linux Installation

sudo apt-get install build-essential unrar-free python3 python3-pip python3-dev

Windows Installation

• Download and install "Python 3.4.x Windows Installer" from http://www.python.org/download/
• Make sure the Python folder is in the PATH Environment Variable, e.g.: ** ;C:\Python34 **
• Download "UnRAR for Windows" from http://www.rarlab.com/rar_add.htm, extract the .exe file, and copy the unrar.exe to any folder on your PATH. E.g.: C:\Python34\

---

Configuration

The user should open "ltv-downloader.py" using a text editor to configure the script.

Here is the description of all the configuration options, available at the beggining of the script

username & password

If you need explanation on these, press alt-f4 The new website version doesn't require login anymore

• default: empty

default_folder

Default folder analyzed when no argument is given (user double-clicked ltv-downloader.py) A '.' means the current working dir, the local folder where the script or shortcut was run from

• default: '.'

preferred_languages

Ordered list of desired languages. The script will try to download preferentially from this order, downloading the best available language Look at the next configurations to understand how a language-upgrade is performed

• default: ['pt', 'br', 'en']

rename_subtitle

If the subtitle file should be renamed to match the video's filename

• default: True

append_language

If used together with rename_subtitle, the subtitle will have the language-code appended (e.g. ShowName.pt.srt)

• default: True

download_each_lang

Download one subtitle file for each of the prefered languages Not yet implemented

• default: False

clean_old_language

If used together with the previous settings, worse languages are deleted when a prefered is available

• default: True

append_confidence

Append a confidence/quality number to then end of the subtitle file. Allows "upgrading" with the same language Most players ignore this last number and correctly identify the srt file. If not, make this False

• default: False

stopSearchWhenExistsLang

Stop if #-Lang is already present: 1-PT, 2-PT/BR, 3-EN/PT/BR etc

• default: = 1

hardlink_without_lang_to_best_sub

This option is useful for some players that can't read subtitle files with language-codes in the name. (e.g. Samsung televisions) If used together with append_language, a hardlink without language-code is created with the shows name (e.g. ShowName.srt), always pointing to the best downloaded subtitle language. In a file explorer, if behaves like any other file, looking like a simple copy of the coded-subtitle, but it occupies no disk-space and is instantaneous to create.

• default: False

confidence_threshold

Advanced stuff. Don't mess with it, unless you are really confortable in your chair.

• default: 50

recursive_folders

If subfolders should be analyzed recursively. In my case I want it off. You can always activate it from the command line with the -r argument. If the '-r' argument is used, any folders FOLLOWING it will be recursed. (e.g. ltv-downloader.py .\NotRecursed\ -r .\Recursed\ ) This option is automatically activated if a single argument is passed. I.e.: ltv-downloader.py .\Recursed\

• default: False

append_iMDBRating

Append or update IMDB rating at the end of movie folders Folders must have the movie name followed by the year inside parenthesis, otherwise they are ignored eg: "Milk (2008)" becomes: "Milk (2008) [7.7]"

• default: True

fix_ETTV_subfolder

Rename, cleans and extracts videos and accompanying subtitles from ETTV-style subfolders

• default: True

clean_original_filename & clean_name_from

With these options, the specified tags and any surrouding brackets/parentesis will be removed from the analyzed files. (e.g. ShowName.[VTV].avi is renamed to ShowName.avi

• default: True, ['VTV', 'www.torentz.3xforum.ro']

Debug

Specifies how many information is printed to console during runtime.