Python script to automatically download subtitles for any movie/tv series episode.
Last updated Jun 30, 2026
784
Stars
232
Forks
22
Issues
+1
Stars/day
Attention Score
39
Language breakdown
No language data available.
โธ Files
click to expand
README
Subtitle Downloader ===================
Python script to download english & Arabic subtitles of any movie/tv series episode.
Get the latest version of Python at http://www.python.org/getit/.
Usage:
If you have python in your path, simply drag and drop files and folders you wish to get subtitles from on subtitle-downloader.pyWindows:
- Install Python
- install click, requests, bs4 libraries
pip install click requests bs4
- Place subtitle-downloader.py file in C:\
- Place the Subtitle.cmd in sendto folder in windows (can be accessed by typing shell:sendto in address bar)
- Right click the movie file (not the movie folder). You can also select multiple files.
- If you want to download subtitles for all movies in a folder, you can use a folder as parameter to subtitle-downloader.py.
Mac:
- Install python and make sure it is in your path
- install click, requests, bs4 libraries
pip install click requests bs4
- Open Automator and create a new document of type "Service"
- Add an action called "Run Shell Script"
- On the top, under 'Service receives selected' drop-down, select 'files or folder' and in the next drop-down, for 'in' select 'Finder'
- On the right top of the Run Shell Script action, make sure you selected "as arguments" for "Pass Input"
- Copy the contents of subtitle.sh in the action
- Edit the path to "subtitle-downloader.py" to wherever you have downloaded
- Press
Command + Sto save it and give some name like "Download Subtitle"
- Now, Right click the movie file (not the movie folder). You can also select multiple files. Click Services -> Download Subtitle
Linux with Nautilus file manager(Tested on Debian Based with nautilus as file manager):
- Install python
- install click, requests, bs4 libraries
pip install click requests bs4
- Go to ~/.local/share/nautilus/scripts/ (Ubuntu 13.04 or above) OR ~/.gnome2/nautilus-scripts/ (Ubuntu 12.10 and below) folder and add Subtitlesinenglish.sh in the folder.
- The path for subtitle-downloader.py is hardcoded to Desktop ...U can change it accordingly.
- Now Right Click on the movie file (not the movie folder). You can also select multiple files. Click Services -> Subtitlesinenglish.

Voila. the .srt subtitle file will be created right next to your movie file.
Enjoy the show!
More details can be found here : http://qr.ae/GxOcx A how to video can be found here: http://www.youtube.com/watch?v=Q5YWEqgw9X8
Linux with NEMO file manager(Tested on Debian Based with NEMO as file manager):
- Install python
- Go to ~/.gnome2/nemo-scripts folder and add SubtitlesInEnglishfornemo.sh in the folder.
- The path for subtitle-downloader.py is hardcoded to Desktop ...You can change it accordingly.
- Open terminal and execute following command :
chmod +x ~/.gnome2/nemo-scripts/SubtitlesInEnglishfornemo.sh
- Now Right Click on the movie file (not the movie folder). You can also select multiple files. Click Services -> SubtitlesInEnglishfornemo.
Development
We would love if you can contribute to make this project better. Here's how you can do it:
- Fork the project.
- Commit changes or bugfixes to your repo.
- Submit a pull request
- Sit back and relax while our maintainers checkout your changes and approve them!
๐ More in this category