Repository files navigation

NON-COMMERCIAL USE ONLY

Subtitle-Downloader supports downloading subtitles from multiple streaming services, such as Apple TV+, CatchPlay, Crunchyroll, Disney+, FridayVideo, HBO GO Asia, iQIYI, iTunes, KKTV, LINE TV, meWATCH, MyVideo, NowE, NowPlayer, Viki, Viu, WeTV, YouTube, etc.

Subtitle-Downloader is a command-line program to download subtitles from the most popular streaming platform. It requiresPython 3.10+, andNodeJS. It should work on Linux, on Windows, or macOS. This project is only for personal research and language learning.

• Linux, macOS:

pip install -r requirements.txt

• Windows: Executeinstall_requirements.bat

1. Install Chrome plugin:get-cookiestxt-locally
2. Login to the streaming service, and use the plugin to download cookies.txt (Don't modify anything even the file name)
3. Put cookie.txt intoSubtitle-Downloader/cookies

• Fill your email and password inSubtitle-Downloader/user_config.toml

1. Save a copy in Drive
2. Connect Colab
3. Install the requirements (Click 1st play button)
4. Depend the download platform and modify the text field (Click the play button next to it when modified completely)
5. Download the subtitles from the left-side menu

1. Depending on the download platform and modifySubtitle-Downloader/user_config.toml

   [subtitles]default-language ='en'# all/en/zh-Hant/zh-Hans/zh-HK/ja/kodefault-format ='.srt'# .srt/.assarchive =true# true/false[headers]User-Agent ='Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36'[credentials.DisneyPlus]email =''password =''[proxies]us ='http:127.0.0.1:7890'# Clash[nordvpn]username =''password =''

2. Follow each platform's requirements and put cookies.txt intoSubtitle-Downloader/cookies

3. Execute the program with the command line orSubtitle-Downloader.bat (Paste the title's URL)

   python subtitle_downloader.py URL [OPTIONS]

  -h, --help                    show this help message and exit  -s --season                   download season [0-9]  -e --episode                  download episode [0-9]  -l, --last-episode            download last episode  -o, --output                  output directory  -slang, --subtitle-language   languages of subtitles; use commas to separate multiple languages                                default: Traditional Chinese                                all: download all available languages  -alang, --audio-language      languages of audio-tracks; use commas to separate multiple languages  -sf, --subtitle-format        subtitles format: .srt or .ass  -locale, --locale             interface language  -p, --proxy                   proxy  -d, --debug                   enable debug logging  -v, --version                 app's version

Disney+

HBO GO Asia

iQIYI iq.com

Viu

WeTV

1. Login tomeWATCH on the browser.
2. Select a movie or series you want to download
3. Open thedevtools in the browser (Windows: Ctrl + Shift + I or F12; macOS: ⌘ + ⌥ + I.)
4. Refresh the page and selectNetwork ondevtools
5. Typehttps://www.mewatch.sg/api/account/profile in the filter to find the profile api
6. Copy profile token (X-Authorization) from profile API Request Headers (Do not includeBearer, the profile token starts witheyJ0eXAiOiJKV1QiLCJhbGciOiJSUzUxMiJ9.eyJ) and paste inSubtitle-Downloader/user_config.toml ([credentials.meWATCH] profile_token='').

• Copy the user-agent from login browserhttps://www.whatsmyua.info/ and paste it inSubtitle-Downloader/user_config.toml (User-Agent). The user-agent must be the same as login browser user-agent.

• Download all seasons and all episodes

python subtitle_downloader.py URL

• Download season 1 episode 1

python subtitle_downloader.py URL -s 1 -e 1

• Download season 1 episode 1's subtitle with all languages

python subtitle_downloader.py URL -s 1 -e 1 -slang all

• Download all episode subtitles in all languages: en, zh-Hant

python subtitle_downloader.py https://www.disneyplus.com/series/loki/6pARMvILBGzF -slang en,zh-Hant

• Download the latest episode

python subtitle_downloader.py URL -l

• Download season 1 episode 1-10

python subtitle_downloader.py URL -s 1 -e 1-10

• Download season 1 episode 1,3,5

python subtitle_downloader.py URL -s 1 -e 1,3,5

• Download season 1 episodes with NordVPN (region=tw)

python subtitle_downloader.py URL -s 1 -p tw

• Download season 1 episodes with proxy (Clash)

python subtitle_downloader.py URL -s 1 -p http:127.0.0.1:7890

• Download season 1 episodes with .ass format subtitle

python subtitle_downloader.py URL -s 1 -sf .ass

• Few streaming services have Geo-blocking, make sure you are in the same region or use a proxy to bypass restrictions.
• Disney+ doesn't support VPN.
• Viki has API protection, don't call API too often. (Only catch 100% completed subtitles)

• Any issue during downloading subtitles, upload the screenshot and log file (Please provide title, platform, and region).
• Make sure the video contains embedded subtitles (subtitles able to turn on and off) and it is playable in your region.

• Please ⭐️ this repository if this project helped you!
• Contributions of any kind are welcome!

• Netflix:Netflix subtitle downloader
• Amazon (Prime Video):Amazon subtitle downloader