NON-COMMERCIAL USE ONLY

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

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

• Linux, macOS:

pip install -r requriements

• Windows: Execute install_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 into Subtitle-Downloader/cookies

• Fill your email and password in Subtitle-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 (Cick the play button next to it when modified complete)
5. Download the subtitles from the left side menu

1. Depend on download platform and modify Subtitle-Downloader/user_config.toml

   [subtitles]
   default-language = 'en'
   default-format = '.srt'
   
   [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 requirements and put cookies.txt into Subtitle-Downloader/cookies

3. Execute the program with command line or Subtitle-Downloader.bat (Paste title 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

• Copy user-agent from login browser https://www.whatsmyua.info/ and paste it in Subtitle-Downloader/user_config.toml (User-Agent). The user-agent must be 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 langugages

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

• Download all episodes subtitles with all langugages: en, zh-Hant

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

• Download 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-off) and it is playable in your region.

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

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