Scan for movies without subtitles and download them!

Issues open


The application enables the user to scan a designated directory for movies. :tv: The application can recognize what file is a movie and can recognize which movie has subtitles. :movie_camera: After the scanning part is completed, the user can choose individual movies for which to download the subtitles in the selected language, or can simply select all the movies. :japan:


This is a project I started as a way to learn Python 3 and to get familiar with the process of creating an application. I chose this theme because I could find use out of it (everyone needs subtitles from time to time). I know this type of application probably already exists and that is why I stated already that the primary reason for making this is to learn and grow as a developer. :mortar_board:


Simply download the repository and run The GUI (example below) will be opened and you can start using the app!

GUI example


The whole application is built in Python 3. The GUI is built with PyQt5 and is designed in QtDesigner. File names are parsed using a package called PTN (parse torrent name) :mega:.

Currently, the source of downloading subtitle data is OpenSubtitles.

During the scanning of a selected directory, each recognized media file is compared with the OMDb database to figure out if the file is a movie. Afterwards, if all the movies have been recognized, the user can select which ones they want to download subtitles for. When the downloading is initiated the screen is freezed (see issues) and the program logs into the OpenSubtitles database. After the successful log in, the program pulls data about the subtitle files and writes those files in their respective movie directories.

Each Python file holds classes which are grouped together thematically:

:star: initializes and runs the GUI

:iphone: class Ui_Subcrawl which contains all the code to generate the GUI

:fax: class Scanner who's task is to scan a designated folder for files and directories

:file_folder: classes Folder and File which help organize the structure of the traversal of files and directories in

:clapper: classes Media and Movie which are in charge of verifying that the media file is a movie and organizing its data

:page_facing_up: class SubtitlePreference which saves the language and source preference that the user chooses and SubtitleDownloader which does the heavy lifting :muscle:

:floppy_disk: class _DBInteractor which is in charge of database interaction, be it storing or retrieving entries

:minidisc: binds all the buttons in the with its logic

Want to help?

If you are willing to get your hands dirty and learn as you work, do not hesitate. Contribute with anything you think will improve the application. Beginners and masters of the craft are welcomed to join! :muscle:

Check the open issues and start there. If you can't find anything of interest, let us know and we will find something! :question: We recommend checking out our contributing guidelines first before starting.


This project is not yet at a point where it can be used as intended. There are still some issues that need to be resolved before it can be used properly.